If a processor does not have a hardware name, and you define the processor in the same IEASYMxx member that you define other processors with hardware names, specify HWNAME() to indicate that a set of definitions is to apply only to the processor with no hardware name.
Value Range: The processor-name is the 1- through 8-character name of the processor on which the system is running. Valid characters are alphanumeric (A-Z and 0-9) and national (@,#,$). The first character must be alphabetic (A-Z) or national (@,#,$).
Default: Match on any hardware name.
HWNAME(C1) /* First test processor */
HWNAME() /* Definitions apply only to processors */
/* to which no hardware name is defined */
A value of LPARNAME() indicates that a set of definitions applies to a processor that is not initialized in LPAR mode. For example, if you run a processor sometimes in LPAR mode and sometimes in basic mode, and you define separate symbols for each mode in the same IEASYMxx parmlib member, specify LPARNAME() to indicate that the system is to process a set of definitions only when running in basic mode.
Value Range: The lpar-name is the 1- through 8-character name of a valid logical partition. Valid characters are alphanumeric (A-Z and 0-9) and national (@,#,$). The first character must be alphabetic (A-Z) or national (@,#,$). Do not specify an lpar-name of all blanks.
Default: Match on any LPAR name.
LPARNAME(TEST1) /* First test system */
LPARNAME() /* Processor is running */
/* in non-LPAR (basic) mode */
If you run a processor sometimes as a guest under VM and sometimes not, and you define both instances in the same IEASYMxx parmlib member, specify VMUSERID() to indicate that the system is to process a set of definitions only when it is not running as a guest under VM.
Value Range: The vm-userid is a 1- through 8-character name of a valid VM system. Valid characters are alphanumeric (A-Z and 0-9) and national (@,#,$).
Default: Match on any VM user ID.
VMUSERID(AUTOLOG1) /* VM system of which MVS is a guest */
VMUSERID() /* Process a set a definitions only when */
/* not running as a guest under VM */
To display the contents of IEASYSxx at the operator console when the system processes each member, specify L anywhere after the first suffix and enclose the values in parentheses. For example, specify (01,L) on SYSPARM to tell the system to process IEASYS01 and display the contents of that member at the operator console. The system ignores the SYSPARM statement if the operator specifies on the LOAD parameter that the system should prompt for system information. The operator can accomplish this by specifying an A, P, S, or T IMSI character on the LOAD parameter on the system console. For details about IMSI characters, see the topic on loading the system software in z/OS MVS System Commands.
Value Range: aa and bb are 1- through 2-character suffixes of a valid IEASYSxx parmlib members. Valid characters are alphanumeric (A-Z and 0-9) and national (@,#,$). Note: Neither static nor dynamic system symbols are accepted.
Default: None. If you omit the SYSPARM parameter, the system uses the default member IEASYS00, the suffixes specified on the SYSPARM parameter in the LOADxx parmlib member, or the suffixes specified by the operator in response to the SPECIFY SYSTEM PARAMETERS prompt.
SYSPARM(00,01) /* IEASYSxx parmlib members 00 and 01 */
Value Range: The system-name is a 1- through 8-character name for an MVS system. Valid characters are alphanumeric (A-Z and 0-9) and national (@,#,$). Static system symbols can be used as long as the values substituted for the symbols are in the value range.
Default: For information about where to specify the system name, how the system determines which name to use, and how the default value is chosen, see Step 3. Determine where to specify the system name.
Each system in a sysplex must specify a unique SYSCLONE value. Message IXC215I is issued if the substitution text for the &SYSCLONE symbol is not unique in a sysplex.
Value Range: Valid characters are alphanumeric (A-Z and 0-9) and national (@,#,$). Static system symbols can be used as long as the values substituted for the symbols are in the value range.
Default: The last two characters of the value specified on the SYSNAME parameter. This default is equivalent to &SYSNAME(-2:2).
SYSCLONE(01) /* First test system */
SYSNAME(S1MVS) /* Specify name for first test system */
SYSCLONE(&SYSNAME(1:2)) /* Resolves to first 2 chars in SYSNAME */
Value Range: &symbol is the 1-8 character name of a system symbol that your installation defines to the system. You can optionally specify an ending period on &symbol.
For ‘sub-text’, there are no restrictions on the types of characters that can be used.
SYMDEF(&MARYJOE.='1234568')
SYMDEF(&FRANKIE.='&MARYJOE(1:2).&MARYJOE(-2:2).ABC')
However, the definition &JOHN='JOHNDOE' is not valid because the resolved substitution text JOHNDOE contains more characters than the system symbol &JOHN.
Default: None. If you omit the SYMDEF parameter, the specified MVS image does not use installation-defined static system symbols.
The following are examples of IEASYMxx usage:
SYSDEF
SYMDEF(&LOGSYM='LOG1') /* Define &LOGSYM for all systems */
SYMDEF(&ABCDEF='OWL') /* Define &ABCDEF for all systems */
SYSPARM(BB) /* Define SYSPARM for all systems */
SYSDEF
HWNAME(T0) /* Identify a test processor */
SYMDEF(&LOGSYM='LOGT') /* Override global &LOGSYM only */
/* for processor T0 */
SYSDEF
LPARNAME(R1) /* Identify a runtime processor */
SYMDEF(&LOGSYM='LOGR') /* Override global &LOGSYM only */
/* for LPAR R1 */
SYSDEF
HWNAME(T0) LPARNAME() /* Identify a non-LPAR processor */
SYMDEF(&LOGSYM='LOGN') /* Override global &LOGSYM only */
/* for T0 in non-LPAR mode */
For this system: &LOGSYM will have this value:
HWNAME LPARNAME
D0 not LPAR mode LOG1 (only first SYSDEF matched)
T0 R1 LOGR (1st, 2nd and 3rd SYSDEF matched)
T0 R2 LOGT (1st and 2nd SYSDEF matched)
T0 not LPAR mode LOGN (1st and 4th SYSDEF matched)
none R1 LOGR (1st and 3rd SYSDEF matched)
SYMDEF(&SYMBOL2='(( ') /* &SYMBOL2 is assigned (( */
SYMDEF(&SYMBOL3='3,3,3 ') /* &SYMBOL3 is assigned 3,3,3 */
.SYMDEF(&SYMBOL1='&SYMBOL2(1:2).&SYMBOL3(1:1).))')
/* &SYMBOL1 resolves to the first two characters in */
/* &SYMBOL2, the first character in &SYMBOL3, and the */
/* two hard-coded right parentheses. &SYMBOL1=((3)) */
SYSDEF
SYMDEF(&SYSR2='&SYSR1(1:4).02') /*SYSR2 resolves to the first */
/*four characters in SYSR1 and */
/*the hard-coded 02. SYSR2=RESA02 */
SYMDEF(&SYSR3='&SYSR1(1:4).03') /*SYSR3 resolves to the first */
/*four characters in SYSR1 and */
/*the hard-coded 03. SYSR3=RESA03 */
SYSDEF
SYMDEF(&SYSR2.='SRS2&SYSR1(-2:2)') /* &SYSR2 resolves to SRS2AA */
SYMDEF(&SYSR3.='SRS3&SYSR1(-2:2)') /* &SYSR3 resolves to SRS3AA */