SET-CODE statement

Format of the statement for assigning authorization codes

Instruction	Operands	Meaning
SET-CODE	CODE = ac / *ALL	(All) authorization codes
	,CONSOLE = *IPL / name / (name,...)	Mnemonic name of the console

CODE = bs/*ALL
Authorization (routing) code (A..Z, 0..9, or “*, #, @, $”) assigned to a physical console or to a logical console with a generated authorization name.
It is also possible to assign all routing codes (*ALL).
Codes 0, *, $ and @ have special meanings (see "Authorization codes with special meanings" in section "Functional areas and their allocation to consoles").

CONSOLE = name / (name,...,name)/*IPL
Mnemonic name of logical consoles with generated authorization names (4 alphanumeric characters) or of physical consoles (2 alphanumeric characters) for which the assignments are to apply.
The console from which the system is loaded (IPL console) can also be addressed with the value *IPL instead of its name.
If a 4-character name is specified then a logical console with this authorization name is automatically generated if this has not already been done.
The first character of the authorization name must not be a digit, nor the character “#”, nor the character “@”. However, it is advisable always to include special characters (#, @ or $) among the four alphanumeric characters, to clearly distinguish them from task sequence numbers (TSN).

By assigning an authorization code, a logical console is authorized for entering operator commands and for receiving messages assigned to this code.

For physical consoles, the effect of the assignment depends on the system parameter NBCONOPI.

• NBCONOPI=N

  By assigning authorization codes, physical consoles too are authorized for entering operator commands and for receiving messages assigned to this code. There is no difference to logical consoles with generated authorization names.

• NBCONOPI=Y
  

  Physical consoles can have explicit or implicit routing codes.

  Only a routing code assigned with the REQUEST-OPERATOR-ROLE command authorizes for both command entry and message receipt (“explicit routing code”).

  Routing codes assigned with SET-CODE are “implicit routing codes” and authorize only for message receipt (and, if required, reply) but not command entry. They also contain the routing code * and can only be assigned to the IPL console (value *IPL).
  Assignments to console names will be rejected (message NBR1202). If necessary, they are automatically transferred from the IPL console to the active main console during the session.

  The NBIMPRCA system parameter defines how long implicit routing codes remain effective (also see section “Assignment of functional areas to consoles” in chapter "Functional areas and their allocation to consoles").

Together, the ADD-CMD-ENTRY and SET-CODE statements can name a maximum of 384 different logical consoles. If more than 384 logical consoles are specified, only the first 384 are accepted.