PROMOTE: Specifying whether a host is eligible for promotion

Explanation: PROMOTE is an optional parameter that allows users to specify which host in an HSMplex may be promoted and which should not be. Currently, one host in an HSMplex is designated as the Primary host and all other hosts are considered secondary. You should specify the PROMOTE parameter on only those hosts that are actually eligible for promotion.

Subparameter	Explanation
PRIMARYHOST (YES\|NO)	Allows you to designate if a host is eligible to take over the unique functions from a failed primary host. PRIMARYHOST(YES) specifies that this specific host in an HSMplex is eligible to take over the unique functions from a failed primary host. If PRIMARYHOST(YES) is issued from a primary host, it is ignored. PRIMARYHOST(NO) specifies that this specific host in an HSMplex is disabled from being eligible for promotion. For example, this can be done if a host is assigned specific work that would conflict with promotion or the host resides on a slow z/OS® image.
SSM(YES\|NO)	Allows you to designate a host's eligibility to take over Secondary Space Management (SSM) functions from a failed host. Secondary Space Management generally runs on a single host. This can be the primary host or a specific secondary host. SSM hosts are not eligible for promotion for other SSM hosts because each SSM host may have different or identical SSM windows and cycles defined. SSM(YES) specifies that this specific non-SSM host in an HSMplex is eligible to take over Secondary Space Management functions from a failed host. If SSM(YES) is issued from a SSM host, the message ARC1521I is issued. SSM(NO) specifies that this specific host in an HSMplex is disabled from being eligible for promotion.

Subparameter

Explanation

PRIMARYHOST (YES|NO)

Allows you to designate if a host is eligible to take over the unique functions from a failed primary host. PRIMARYHOST(YES) specifies that this specific host in an HSMplex is eligible to take over the unique functions from a failed primary host. If PRIMARYHOST(YES) is issued from a primary host, it is ignored. PRIMARYHOST(NO) specifies that this specific host in an HSMplex is disabled from being eligible for promotion. For example, this can be done if a host is assigned specific work that would conflict with promotion or the host resides on a slow z/OS® image.

SSM(YES|NO)

Allows you to designate a host's eligibility to take over Secondary Space Management (SSM) functions from a failed host. Secondary Space Management generally runs on a single host. This can be the primary host or a specific secondary host. SSM hosts are not eligible for promotion for other SSM hosts because each SSM host may have different or identical SSM windows and cycles defined. SSM(YES) specifies that this specific non-SSM host in an HSMplex is eligible to take over Secondary Space Management functions from a failed host. If SSM(YES) is issued from a SSM host, the message ARC1521I is issued. SSM(NO) specifies that this specific host in an HSMplex is disabled from being eligible for promotion.

SMS relationship: Parameter has the same meaning when applied to SMS-managed or non-SMS-managed DASD volumes or data sets.

SETSYS default: None.

DFSMShsm default: If you do not specify this parameter on any SETSYS command, no hosts in an HSMplex are eligible to take over the Primary or Secondary Space Management functions of a failed host.

Note: The SETSYS PROMOTE parameter only makes the host eligible to be promoted for Primary or SSM hosts that become disabled after the command was issued. If you want to make the host take over for a host that is already disabled, you can issue the SETSYS NOEMERGENCY command on this host, which will cause the host to go and look for hosts that are already disabled and in need of being promoted.