Previous Topic: &MAISGET

Next Topic: &MASKCHK


&MAISPUT

The &MAISPUT verb updates MAI session list entries, or the defaults.

This verb has the following format:

&MAISPUT { ID=sessid | RELNUM=nn | DEFAULTS }
         [ PREFIX={ MAI | prefix} ]
         [ FIELDS={ name | ( name1,name2,...,namen ) } ]

Operands:

ID=sessid

Specifies the one- to eight-character session identifier that uniquely identifies a defined MAI-FS session to update.

RELNUM=nn

Specifies the numerical position of a relative session within the defined list to update.

DEFAULTS

Updates the default session details.

PREFIX={ MAI | prefix }

Specifies the prefix for the user variables to update. The user variable names are formed by concatenating the PREFIX operand value with the field names specified on the FIELDS operand.

Default: MAI

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

Specifies the field names of the user variables to update. The user variable names are formed by concatenating the PREFIX operand value with the field names specified on this operand. The following table shows the fields that are specified on this operand:

Field Name

Description

Value

NODE

Specific virtual terminal

Null or 1-to 8-character name

LOGON

Logon string

1 through 50 characters

SESS

Session identifier

1 through 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

Seen 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.