The syntax of the PARMLIB command is:

• PARMLIB is an authorized command.
• If RACF® is installed and active, you require either authority to the RACF PARMLIB resource of the RACF TSOAUTH resource class or authority through the installation exit routine, IKJPRMX1, to issue the command. (See z/OS TSO/E Customization for detailed information concerning IKJPRMX1.)
• If RACF is not installed or active, you require authority either through an equivalent security product or through the installation exit routine to issue the command.

LIST

Display specifications in the active IKJTSOxx member of SYS1.PARMLIB.

The output of the PARMLIB LIST command also shows the system that created the PARMLIB member, the timestamp and the user id of the person who issued the PARMLIB UPDATE command.

In sysplex systems this command can be used to display the PARMLIB settings on one, all, or a subset of the systems in the sysplex by specifying the ROUTE operand (see ROUTE). In sysplex systems, the responses are gathered together and grouped so that all systems which have the same settings are shown in one display.

Figure 1. Sample PARMLIB LIST Output

 TSO/E PARMLIB SETTINGS: 

    SYS2.PARMLIB(IKJTSOWS) ON VOLUME vvvvvv
    Activated by user uuuuuuu on YYYY-MM-DD at HH:MM:SS from system ssssssss
    Applies to        TSOA     TSOB

    SYS1.PARMLIB(IKJTSOFF) ON VOLUME vvvvvv
    Activated by user uuuuuuu on YYYY-MM-DD at HH:MM:SS from system ssssssss
    Applies to        TSOC

          CURRENT SETTINGS FOR CONSOLE:

          INITUNUM              1000
          INITSNUM              1000
          MAXUNUM              10000
          MAXSNUM              10000

    ---------------------------------------------------------------------------

    SYS1.PARMLIB(IKJTSOAB) on volume vvvvvv
    Activated by user STCUSER on YYYY-MM-DD at HH:MM:SS from system TSOE
    Applies to        TSOE

          CURRENT SETTINGS FOR CONSOLE:

          INITUNUM              1000
          INITSNUM              1000
          MAXUNUM              20000
          MAXSNUM              20000

ALL

Display all the specifications in the active IKJTSOxx member of SYS1.PARMLIB

statement_name

Only display the specifications from an individual statement in the active IKJTSOxx member of SYS1.PARMLIB

value:

as indicated in the following list:

ALLOCATE

ALLOCATE command default data set status

AUTHCMD

list of authorized commands

AUTHPGM

list of programs that are authorized when invoked via the CALL command

AUTHTSF

list of programs that are authorized when invoked through the TSO/E service facility

CONSOLE

message processing defaults for the CONSOLE command and its services

HELP

list of help data sets for different languages

LOGON

list of options for LOGON processing

NOTBKGND

list of commands not supported in the background

PLATCMD

list of commands that can run on the TSO/E command invocation platform

PLATPGM

list of programs that can run on the TSO/E command invocation platform when invoked through TSO/E service facility

SEND

SEND, OPERATOR SEND, and LISTBC command defaults and active broadcast data set information

TEST

list of additional commands and subcommands valid under TEST and TESTAUTH

TRANSREC

TRANSMIT/RECEIVE command options and defaults

For detailed information concerning each of the statements in the IKJTSOxx member of SYS1.PARMLIB, see z/OS MVS Initialization and Tuning Reference.

UPDATE

Dynamically change, without a re-IPL, the active IKJTSOxx member of SYS1.PARMLIB.

In sysplex systems this command can be used to update one, all, or a subset of the systems in the sysplex by specifying the ROUTE operand (see ROUTE).

When updating sysplex systems, every symbolic variable in the specified IKJTSOxx member of SYS1.PARMLIB is resolved on the system where the command is issued and run and then the resulting information is passed on to the systems as specified by the ROUTE operand (seeROUTE).

When updating sysplex systems, if the command fails on any of the systems, no backout is done on the systems that completed the PARMLIB UPDATE successfully.

Before you change the active IKJTSOxx member using the PARMLIB UPDATE command, it is highly recommended that you check the syntax of the member using the PARMLIB CHECK command (see below).

See z/OS TSO/E Customization for detailed information on using SYS1.PARMLIB versus CSECTS IKJEFTE2, IKJEFTE8, IKJEFTAB, and IKJEFTNS to maintain the lists of authorized commands and programs, and commands not supported in the background.

member_name_suffix

Identification of the now active IKJTSOxx member of SYS1.PARMLIB

value:

a maximum of two alphabetic and/or numeric characters

The system appends the two characters to IKJTSO to identify the specified member. You are responsible for ensuring that the member exists in parmlib.

ROUTE

In a sysplex, the ROUTE operand causes the PARMLIB command processor to gather information from (LIST operand) or send information to (UPDATE operand) the specified systems in the sysplex.

When the LIST operand is specified, the PARMLIB command processor gathers information from the specified systems and presents the information on the system where the PARMLIB command is issued.

When the UPDATE operand is specified, the PARMLIB command processor resolves every symbolic variable in the specified member and then sends identical information to each of the specified systems. If no broadcast data set switch is detected on the system where the command is issued, no prompt for confirmation will occur, even if the PARMLIB UPDATE results in a broadcast data set switch on one or more systems in the sysplex. The PROMPT/NOPROMPT keyword has no effect beyond the system where the command is issued. If a separate prompt for each system is needed, consider using the MVS ROUTE *ALL,SET IKJTSO=xx command instead.

*

All systems in the sysplex.

systemname

Only one system in the sysplex.

groupname

Only the named subset of systems in the sysplex.

Systemname and groupname are in MVS name token format. For defining them, use the MVS program IEEGSYS. For more information about IEEGSYS, see z/OS MVS Planning: Operations.

CHECK

Check the syntax of any IKJTSOxx member of SYS1.PARMLIB

member_name_suffix

Identification of the IKJTSOxx member of SYS1.PARMLIB

value:

a maximum of two alphabetic and/or numeric characters

The system appends the two characters to IKJTSO to identify the specified member. You are responsible for ensuring that the member exists in parmlib.