z/OS MVS Using the Subsystem Interface
Previous topic | Next topic | Contents | Contact z/OS | Library | PDF


Format of the Variable Output Sections

z/OS MVS Using the Subsystem Interface
SA38-0679-00

The following is a description of the subsystem and installation variable output sections:
Field Name
Description
SSVIVLEN
A 2-byte signed hexadecimal field that contains the length of the variable output data string. The length of this field is not included in the length of the string.
SSVIDAT
A variable length character string (its length is set through SSVIVLEN) that contains a set of keywords and their respective values. When master (MSTR) or JES is the called subsystem, any, all or none of the keyword values shown in Table 1 are returned to the SSI code 54 caller.

Procedure of Searching Data Strings: When searching the variable output data strings, IBM® recommends that installations have their SSI code 54 callers search the installation variable output section, if one exists, before searching the system variable output section. (The callers would use the first instance of a searched for keyword.) By following this procedure, the installation can add its own values to those returned by the SSI, and override the system values, without actually changing the information in the system variable output section.

IBM-Defined Keywords: The following table shows the IBM-defined keywords that can be returned in the variable-length character string:

Table 1. IBM-Defined Keywords
Keyword Explanation
,AUTO_RESTART_MANAGER='YES|NO' Indicates whether the subsystem supports using the automatic restart manager.
,CLIENT_PRINT='YES' Indicates that the JES supports the creation of a client token in support of client printing.
,COMMAND_PREFIX='prefix' Indicates the operator command prefix that is registered for this subsystem. For JES2, this is the value of CONDEF CONCHAR=. JES3 supplies the first system scoped synonym.
,DYNAMIC_OUTPUT='YES|NO' Indicates whether the subsystem supports the dynamic output feature.
,EXW_SYSOUT_CLASS='classes' Indicates the SYSOUT class for which output is placed on the HOLD queue and is held for external writers. (See note.) This keyword is not applicable to JES2.
,FOUR_DIGIT_DEVNUMS='YES|NO' Indicates whether the subsystem supports 4-digit device numbers.
,GLOBAL_PLEVEL='mmm' The JES3 global product level in decimal EBCDIC digits. (JES3 only).
,GLOBAL_SLEVEL='mmm' The JES3 global service level in decimal EBCDIC digits. (JES3 only).
,GLOBAL_RELEASE='release' The JES3 release running on the JES3 Global. (JES3 only.)
,GLOBAL='system name' The system name of the JES3 Global. (JES3 only).
,INITIATOR_RESTART='YES|NO' Indicates whether the subsystem supports the restarting of initiators.
,JES_NODE='name' Specifies the network node name of the JES.
,JES_MEMBERNAME='name' Specifies the member name of a particular JES2 in a multi-JES configuration or the JES3 main name in a JES3 complex.
MULT_CHAR_JOBCLASS=YES|NO|UNSP YES indicates that one or more 2-8 character job classes are defined on the MAS. NO indicates that the MAS supports 2-8 character job classes, but none are defined. UNSP indicates that 2-8 character job classes are not currently supported, because an active member of the MAS is running a z/OS version earlier than 2.1.
,MULTIPLE_STCTSO='YES|NO' Indicates whether the subsystem supports dynamic allocation of multiple started task (STC) and TSO/E internal readers.
,PLEXSYN='list of plex synonyms' The list of sysplex scoped command prefix synonyms from the CONSTD PLEXSYN= definition. (JES3 only.)
,SAPI_CHARS='NO' Indicates selection by characters not supported.
,SAPI_IP_SELECT='NO' Indicates selection by IP address (Internet protocol) not supported.
,SAPI_MOD_SELECT='NO' Indicates selection by modification id not supported.
,SAPI_PRTY_SELECT='NO' Indicates selection by priority not supported.
,SAPI_VOL_SELECT='NO' Indicates selection by volume not supported.
,SAPI='YES' Indicates SAPI is supported by this JES.
,SPOOL_BROWSE='YES' Indicates that spool browse is supported on this release of JES3. (JES3 only. On JES2 all releases support spool browse.) The text SPOOL_BROWSE='NO' is never supplied. On the JES3 releases that do not support spool browse, the entire SPOOL_BROWSE keyword is omitted.
,SYN='list of system synonyms' The list of system scoped command prefix synonyms from the CONSTD SYN= definition. (JES3 only.)
,TSO_SYSOUT_CLASS='classes' Indicates the SYSOUT class for which output is placed on the HOLD queue, and is held for TSO/E. (See note.) For JES2, classes are held for SYSOUT.
,WTR_SYSOUT_CLASS='classes' Indicates the SYSOUT class for which output is placed on the JES3 writer queue. (See note.) For JES2, classes are for non-held SYSOUT.
Note: class can be a value of A through Z or 0 through 9.

No blanks or commas are returned.

For JES3, classes that are defined to have SYSOUT directed to NJE are not returned.

For JES3, classes that are defined to have zero copies created are not returned.

For JES3, classes that are defined to be held for both TSO as well as external writers are not returned.

The format of the data in the variable output sections is:
,keyword='value',keyword='value',...,keyword='value'

Note that each keyword value in the data string is enclosed by a pair of apostrophes and preceded by a comma. All values must be uppercase.

Restrictions for Variable Output Section: Double-byte character set information is not currently recognized for variable output section strings.

Go to the previous page Go to the next page




Copyright IBM Corporation 1990, 2014