PARMLIB command

Use the PARMLIB command to:

Display the specifications in the active IKJTSOxx member of SYS1.PARMLIB for:
- one system
- all systems in a sysplex, or
- a subset of systems in a sysplex
Dynamically change the active member without a re-IPL for:
- one system
- all systems in a sysplex, or
- a subset of systems in a sysplex
Check the syntax of any IKJTSOxx member of SYS1.PARMLIB.

Note: You can also place IKJTSOxx members in data sets other than SYS1.PARMLIB. This extra flexibility allows you, for example, to separate your data from IBM® supplied data. You can specify a list of PARMLIB data sets that will comprise a logical concatenation (logical PARMLIB) for the life of the MVS™ system (similar to LPALST and LNKLST for LPA and link-list libraries).

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.