SNAX Creator-2 Configuration and Control Manual

ALTER SU Command
SCF Commands for SNAX Creator-2
4–14 117143 SNAX Creator-2 Configuration and Control Manual
ALTER SU Command The ALTER SU command changes the values of specified attributes of an existing SU
object defined to the SNAX Creator-2 subsystem. It is a sensitive command.
ALTER SU command syntax is as follows:
ALTER [ / OUT file-spec / ] SU manager-name.object-name
[ , NAMERULE { PLUNAMEONLY | FIRSTWORD | expression } ]
[ , PASSWORD [ password | expression ] ]
[ , PLUNAME [ pluname | expression ] ]
OUT
causes any SCF output generated for this command to be directed to the file
file-spec ; it is described in the Subsystem Control Facility (SCF) Reference Manual.
manager-name
is described in Section 3, “Objects for SNAX Creator-2.”
object-name
is an SU object name, as described in Section 3, “Objects for SNAX Creator-2.”
attribute-spec
is a list of attributes with the new values to be assigned to them. All attributes are
described in Section 5, “Attributes and Built-in Functions for SNAX Creator-2.”
Considerations
The ALTER SU command requires that the SU object be in the STOPPED state.
The attributes are evaluated whenever the SU is restarted; if the attributes are
invalid, the SU object is put into the SUSPENDED state.
In the ALTER SU command, specifying the PASSWORD attribute without a value
resets the attribute to its default value (that is, eight blanks).
In the ALTER SU command, specifying the PLUNAME attribute without a value
invalidates any previously specified value.
Examples
The following example alters the PLUNAME attribute of an SU object:
ALTER SU $CREA.$SSCP.#SUBD1, PLUNAME MAIL
The following alters all SU objects for the specified access method:
ALTER SU $CREA.$SSCP.*, PLUNAME MAIL