Verbs and Built-in Functions › &MAISADD

&MAISADD

Adds a new session definition, based on user variables.

&MAISADD [ PREFIX={ MAI | prefix} ]
         [ FIELDS={ name | ( name1,name2,...,namen ) } ]

Used to add a new session definition with the attributes specified in the FIELDS operand.

Operands:

PREFIX={ MAI | prefix }

Specifies the prefix for the user variables to be accessed for the session details. The default is MAI. The user variable names are formed by concatenating the PREFIX operand value with the field names specified on the FIELDS operand.

FIELDS={ name | name1,name2,...,namen }

Specifies the field names of the user variables to be accessed. The user variable names are formed by concatenating the PREFIX operand value with the field names specified on this operand. The following fields can be specified on this operand:

NODE

Specific virtual terminal

Null or 1- to 8-character name

LOGON

Logon string

1 to 50 characters

SESS

Session identifier

1 to 8 characters

FJMP1/2

Jump forward key

Null or Fnn/PFnn/PAn/ATTN

RJMP1/2

Jump reverse key

Null or Fnn/PFnn/PAn/ATTN

MENU1/2

Jump to menu key

Null or Fnn/PFnn/PAn/ATTN

SISM

Screen Image Services menu key

Null or Fnn/PFnn/PAn/ATTN

SISP

Screen print key

Null or Fnn/PFnn/PAn/ATTN

SWAP1/2

Swap to other window key

Null or Fnn/PFnn/PAn/ATTN

REST

Restart option

Y or N

WAIT

Wait option

Y or N

FJUMP

Fast jump option

Y or N

COMP

Compression option

Y or N

LMODE

Specific logmode

Null or 1- to 8-character name

SCTPR

Script name and option

Null or 1- to 8-character name

Return Codes:

On completion, the &RETCODE system variable is set as follows:

0

The function completed successfully.

4

An error in the attributes was detected. &SYSMSG is set and the NCL variable is updated with the ERR attribute.