OPS/REXX Built-in Functions › OPSIPL Function

OPSIPL Function

The OPSIPL function obtains the parameter library member suffix and value of the requested IPL parameter. This information is obtained from the IPA control block of z/OS.

Note: The OPSIPL function can be used in OPS/REXX, AOF rules, TSO/E REXX, or CLIST.

This function has the following format:

var= OPSIPL(member prefix,parameter)

member prefix

The member prefix argument specifies the fixed portion of the Logical Parmlib Concatenation member name, which is associated with the subsequent parameter specification. The first data item returned is always the two-character suffix of the member name from which the associated parameter was derived by the system at IPL.

Possible values for the member prefix are:

LOAD

The subsequent parameter keyword is associated with a LOADxx member of the Logical Parmlib Concatenation, or the IPL parameters specified by the operator from the service console.

IEASYS

The subsequent parameter keyword is associated with an IEASYSxx member of the Logical Parmlib Concatenation. Since multiple IEASYSxx members may be used for the IPL, the suffix value returned is important in determining the actual IEASYSxx member that is the source of the parameter value.

parameter

The parameter argument identifies the keyword data item of the member prefix for which the value is desired.

The following are the LOADxx-related parameters:

• HWNAME-The HCD name of the central processor complex
• IEASYM-The suffix string of the IEASYMxx members
• IODF-The I/O definition file statement image
• IODFUNIT-The IODF unit address
• IPLDEVICE-The IPL load parameter data set device number
• IPLDSN-The IPL load parameter data set name
• IPLFLAGS-The LOADxx usage flags (1 byte binary).

  Possible values are:

  • X'80'-If this bit is on, the system used the Master JCL from PARMLIB. If this bit is off, the system used the Master JCL from LINKLIB.
  • X'40'-If this bit is on, the system used the Master JCL IEFPARMS DD parameter libraries. If this bit is off, the system used the LOADxx parameter libraries.

    The LOADxx usage flags (2 bytes binary). Possible value is:

  • X'00'-The Master JCL came from LINKLIB
• IPLIMSI-The initial message suppression character from the IPL

• IPLTOD-The load parameter suffix followed by the date and time of completion of system initialization.

  (ss yy/mm/dd HH:MM:SS)
  

• LPARNAME-The partition name, in HCD or IOCP
• MTLSHARE-The MTLSHARE value (Y or N), enables a full-support MTL system to treat manual tape library defined devices as stand-alone devices.
• NUCLEUS-The one-digit suffix of the selected nucleus IEANUC0n
• NUCLST-The suffix of the NUCLSTxx parameter library member and wait flag
• PARMLIB0-The number of parmlib data sets defined
• PARMLIB1-The first parameter library DSN, volume serial number, and usage flag (1 byte binary)
• PARMLIB2-The second parameter library DSN, volume serial number, and usage flag
• PARMLIB3-The third parameter library DSN, volume serial number, and usage flag
• PARMLIB4-The fourth parameter library DSN, volume serial number, and usage flag
• PARMLIB5-The fifth parameter library DSN, volume serial number, and usage flag
• PARMLIB6-The sixth parameter library DSN, volume serial number, and usage flag
• PARMLIB7-The seventh parameter library DSN, volume serial number, and usage flag
• PARMLIB8-The eighth parameter library DSN, volume serial number, and usage flag
• PARMLIB9-The ninth parameter library DSN, volume serial number, and usage flag
• PARMLIB10-The tenth parameter library DSN, volume serial number, and usage flag
• PARMLIB11-The eleventh parameter library DSN, volume serial number, and usage flag.
• PARMLIB12-The twelfth parameter library DSN, volume serial number, and usage flag.
• PARMLIB13-The thirteenth parameter library DSN, volume serial number, and usage flag.
• PARMLIB14-The fourteenth parameter library DSN, volume serial number, and usage flag.
• PARMLIB15-The fifteenth parameter library DSN, volume serial number, and usage flag.
• PARMLIB16-The sixteenth parameter library DSN, volume serial number, and usage flag.
• PARMLIB17-The seventeenth parameter library DSN, volume serial number, and usage flag.
• SYSCAT-The Master catalog definition statement image
• SYSPARM-The suffix string for IEASYSxx members
• SYSPLEX-The name of the sysplex that the system participates in
• VMUSERID-The z/VM userid under which the guest system is running

Following are the IEASYSxx-related parameters:

• ALLOC-The suffix string for ALLOCxx members
• APF-The suffix for IEAAPFxx member
• APG-The automatic priority group dispatching priority
• BLDL-The obsolete suffix for the IEABLDxx member
• BLDLF-The obsolete suffix for the IEABLDxx member
• CEE-The suffix string for the CEEPRMxx members
• CLOCK-The suffix string for the CLOCKxx members
• CLPA-The create link pack area option
• CMB-The additional device classes for measurement data
• CMD-The suffix string for the COMMNDxx members
• CON-The suffix string for the CONSOLxx member and the JES3 option
• CONT-The operator used CONT on console override reply
• COUPLE-The suffix string for COUPLExx member
• CPQE-Unknown parameter
• CSA-The size of CSA and ECSA
• CSCBLOC-The location of CSCB control blocks ABOVE/BELOW
• CVIO-The clear VIO data set option
• DEVSUP-The suffix string for DEVSUPxx members
• DIAG-The suffix string for DIAGxx members
• DRMODE-Specifies that an IPL of a recovery system occurs as part of a disaster recovery scenario that requires special handling of certain resources
• DUMP-The SYS1.DUMPxx data sets on the DASD option and the suffix range
• DUPLEX-The data set name of the duplex page data set
• EXIT-The suffix string for the EXITxx member
• FIX-The suffix string for the IEAFIXxx members and the protect option
• GRS-The GRS participation initialization parameter
• GRSCNF-The suffix string for the GRSCNFxx member for GRS
• GRSRNL-The suffix string for the GRSRNLxx members or EXCLUDE
• ICS-The suffix string for the IEAICSxx member for SRM
• IKJTSO-The suffix string for the IKJTSOxx member
• IOS-The suffix string for the IECIOSxx member for MIH and I/O
• IPS-The suffix string for the IEAIPSxx member for SRM
• LFAREA-Specifies the amount of central storage to be made available to back large pages.

  Note: This value is only available at z/OS 1.9 and higher

• LICENSE-Specifies whether this is a z/OS or a z/OS.e system.
• LNK-The suffix string for LNKLSTxx
• LNKAUTH-The linklist authorization option LNKLST/APFTAB
• LOGCLS-The JES output class for SYSLOG data sets
• LOGLMT-The number of WTLs per SYSLOG file
• LOGREC-The LOGREC data set name or recording medium
• LPA-The suffix string for LPALSTxx members
• MAXCAD-The number of SCOPE=COMMON data spaces available to all users
• MAXUSER-The maximum number of concurrent address spaces
• MLPA-The suffix string for the IEALPAxx members and the protect option
• MSTRJCL-The suffix string of the MSTRJCLxx member for the Master JCL
• NONVIO-The list of NON-VIO eligible page data set names
• NSYSLX-The number of additional system linkage indexes
• NUCMAP-Obsolete parameter
• OMVS-The suffix string for the BPXPRMxx members for OpenEdition
• OPI-Allow operator overrides of IEASYSxx members YES/NO
• OPT-The suffix string of the IEAOPTxx member for SRM
• PAGE-The list of page data set names
• PAGEO-The list of page data set names entered by the operator
• PAGNUM-The obsolete parameter replaced by PAGTOTL
• PAGTOTL-The maximum number of PAGE and SWAP data sets
• PAK-The suffix string for IEAPAKxx members
• PLEXCFG-The type of system configuration into which system can start
• PRESCPU-Causes system initialization processing to bring logically online the CPUs that appear to MVS to be physically online, without regard to the number of CPUs defined to be initially online in the logical partition profile
• PROD-The suffix string for the IFAPRDxx members
• PROG-The suffix string for the PROGxx members
• PURGE-The obsolete option to dismount MSS volumes
• RDE-Include reliability data extractor YES/NO
• REAL-The maximum storage for V=R jobs
• RER-The reduced error recovery for magnetic tapes YES/NO
• RSU-The central storage units available for reconfiguration
• RSVNONR-The number of reserved entries in ASVT for non-reusable entries
• RSVSTRT-The number of reserved entries in ASVT for START
• RTLS-The suffix string for the CSVRTLxx member
• SCH-The suffix string for the SCHEDxx members
• SMF-The suffix string for the SMFPRMxx member for SMF
• SMS-The suffix string for IGDSMSxx member for SMS
• SQA-SQA and ESQA sizes
• SSN-The suffix string for the IEFSSNxx members
• SVC-The suffix string for the IEASVCxx members
• SWAP-The SWAP data set name list
• SYSNAME-The system name
• SYSP-The suffix string for the IEASYSxx members used for IPL
• UNI-The suffix string for the CUNUNIxx members
• VAL-Suffix string for VATLSTxx members
• VIODSN-The name of the VIO journal data set
• VRREGN-V=R region size

Documentation on the meaning and format of all parameters can be found in the z/OS Initialization and Tuning Reference and in the z/OS macro IHAIPA.

Examples: OPSIPL

• Example 1

  Display the IODF statement of the LOADxx member and parse the result:

  iodf = OPSIPL('LOAD' , 'IODF')
    >>> iodf = '00 00 IODF       CONFIGPR'
  Parse Var iodf load_suffix iodf_stmt
  Parse Var iodf_stmt iodf_suffix 3 . 4 iodf_hlq 12 . 13,
            iodf_config 21 . 22 iodf_edt 24 . 25 iodf_devsup 26
  

• Example 2
  1. Display the value of the CMD parameter of the IEFSYSxx member.
  2. Display the result.
  3. Read each member into the external data queue:

     cmdx = OPSIPL('IEASYS','CMD')
       >>> cmdx = '01 (00,44,A2)'
     Parse Var cmdx ieasys_suffix cmdval
     cmdval = Strip(Translate(cmdval,,'(,)'))
     Do while cmdval <> ''
       Parse Var cmdval suffix cmdval
       pcnt = OPSPRMLB('LISTMEM','COMMND'||suffix)
     End
     

• Example 3
  • Display the value of the CSCBLOC parameter of IEASYSxx.
  • Assume that it was not specified, and that the system used the default value:

    Say  OPSIPL('IEASYS','CSCBLOC')
      >>> D ABOVE
    

• Example 4

  Some parameters yield null values when they are not specified:

  Say  OPSIPL('IEASYS','DEVSUP')
    >>> '