z/OS V1R9.0 TSO/E Command Reference

ALTLIB Command(*) indicates that you want to activate or deactivate REXX execs and CLISTs at thelevel you specify (user, application, or system).DATASET(dsname) | DSNAME(dsname)specifies a data set list to define an application-level library of REXX execs orCLISTs. When specifying DATASET or DSNAME:v The data sets must be cataloged partitioned data sets when you issue theALTLIB command.v The maximum number of data sets you can list is fifteen. Use the FILEoperand if you want to specify more than fifteen.v The data sets must all have the same record format (RECFM).v If the data sets have different block sizes, you can specify them in any orderof block sizes.v Member names cannot be specified in the list of data sets.FILE(ddname) | DDNAME(ddname) | LIBRARY(ddname)specifies a ddname that defines an application-level library.v The ddname must be allocated before issuing the ALTLIB command.v The ddname must be allocated with the permanently allocated attribute toensure that the system does not automatically deallocate the ddname whenthe allocation control limit is exceeded. Note that the data sets allocated in aLOGON procedure or by the ALLOCATE command are automaticallyallocated with this attribute, however, if you access dynamic allocationdirectly, using SVC 99, you need to specify this attribute. For moreinformation about the permanently allocated attribute, see z/OS MVSProgramming: Authorized Assembler Services Guide.v To avoid errors when the EXEC command runs, specify only catalogedpartitioned data sets.UNCOND | CONDUNCONDactivates the specified application-level library even if anotherapplication-level library of the same type, CLIST or REXX exec, is activewithin the current application. Up to eight application-level CLIST and REXXexec requests can be stacked. (See Stacking Application-Level libraryrequests for an explanation of stacking.)CONDactivates the specified application-level library only if anotherapplication-level library of the same type, CLIST or REXX exec, is notactive within the current application. If you issue the ALTLIB command withthe COND keyword and there is already an application-level library in effect,a message is displayed and a non-zero return code is set.QUIETindicates that you want messages saved and not displayed at the terminal.Messages can be saved in the ISPF shared pool when QUIET is used andISPF is active. Variable IKJADM1 contains the first message, variable IKJADM2contains the second message, and so on. Variable IKJADM contains thenumber of messages returned for the invocation of ALTLIB according to theserules:v If you specify ALTLIB with QUIET, IKJADM is reset to the number ofmessages returned for that invocation of ALTLIB.v If you do not specify the QUIET operand, IKJADM is not reset. It equals thenumber of messages returned for the last invocation of ALTLIB with QUIET.60 z/OS V1R9.0 TSO/E Command Reference