SYSNAME

SYSNAME=name

This parameter optionally specifies the name that identifies this system. The name must be 1-8 characters long; the valid characters are A-Z, 0-9, $, @, and #. The name specified remains in effect for the duration of the IPL. The following values can override the value specified on the SYSNAME parameter:

The value specified on the SYSNAME parameter in the IEASYMxx parmlib member.
The value specified on the SYSNAME parameter in one or more alternate sets of parameters in IEASYSxx. The operator specifies the alternate parameters on the SYSP parameter on the REPLY command.

The value of SYSNAME is also the substitution text for the &SYSNAME system symbol. &SYSNAME can be specified in parmlib members to help support multisystem environments. For details about how to use &SYSNAME and other system symbols, see Sharing parmlib definitions.

The system name defined by the SYSNAME parameter is used during the initialization of global resource serialization to identify the GRSDEF statement in the GRSCNFxx parmlib member that is to apply to this system. The system prompts the operator for a valid system name if the system name specified does not have the proper syntax. If the system name specified does not match any of the MATCHSYS keyword values in the GRSCNFxx parmlib member, the operator is informed, via an error message, to either reload the initial program or specify GRS=NONE. The operator also uses the system name defined by SYSNAME parameter to refer to the system in the system commands that control global resource serialization.

The system name defined by the SYSNAME parameter is also used to identify the originating system for messages in the multiple console support (MCS) hard-copy log and in the display created by the DISPLAY R command. Without specific SYSNAME= values in multisystem complexes, it is impossible to determine which system actually issued the message in the hard-copy log. SYSNAME will be used in the SYSLOG heading and in all message formats where the system name is requested.

System logger may use the system name as part of the staging data set name. The system name specified here allows you to use a digit as the first character, but this is not valid in a staging data set name. If you use a digit as the first character in the system name, system logger substitutes 'STG' for the digit and uses part of the system name as the low level qualifier for the staging data set name. For complete information, see z/OS MVS Setting Up a Sysplex and look for the topic on Naming Conventions for the Log Stream and DASD Log data sets.

Value Range: 1-8 of these characters: A-Z, 0-9, $, @, #.

Default Value: If the system name is not specified in IEASYMxx or IEASYSxx, the default is one of the following:

The processor name that is defined to HCD (if not in LPAR mode).
The LPAR name for the processor.
The VM userid, if the MVS™ image is running as a guest under VM/ESA.

Associated Parmlib Member: None