SAVE Create Procedure with ADD-/MODIFY-USER Commands

ONXSAVE file [, DO | ENTER] [, DEFCAT=[defc] ] [, PVS=[pvs] ] [, PUBSP=[val] ] [, UID= [userid] ] [, AU] [, GR] [, ACC] [, MAIL] [, NPASS] [, PASS] [, LP] [, NSTD] [, POSIX] [, SM] [, PRIV] [, OPR] [, TSET]

A BS2000 procedure containing ADD-/MODIFY-USER commands will be created. This can then be used to re-create the Join file if required.

file Name of the file to which the procedure should be written.

DO A DO procedure will be created (default).

ENTER An Enter file will be created.

DEFCAT= A DO procedure with PROC A,(&DEFC=),SUBDTA=& will be created.

The DEFAULT-PUBSET parameter in the MODIFY-USER command will be replaced with the &DEFC procedure variable value. The current value of &DEFC will be requested when the DO procedure is executed.

defc The &DEFC parameter in the DO procedure will be substituted with the value specified: PROC A,(&DEFC=defc),SUBDTA=&.

Example: DEFCAT=ABC

PVS= A DO procedure with PROC A,(&PVS=),SUBDTA=& will be created. The PUB-VOL-SET parameter in the MODIFY-USER command will be replaced with the &PVS procedure variable value. The current value of &PVS will be requested when the DO procedure is executed.

pvs The &PVS parameter in the DO procedure will be substituted with the value specified: PROC A,(&PVS=pvs),SUBDTA=&.

Example: PVS=A

PUBSP= A DO procedure with PROC A,(&PUBSP=),SUBDTA=& will be created.

The PUBSPACE parameter in the MODIFY-USER command will be replaced with the &PUBSP procedure variable value. The current value of &PUBSP will be requested when the DO procedure is executed.

val The &PUBSP parameter in the DO procedure will be substituted with the value specified: PROC A,(&PUBSP=val),SUBDTA=&.

UID= A DO procedure with PROC A,(&UID=),SUBDTA=& will be created. The userid parameter in the MODIFY-USER command will be replaced with the &UID procedure variable value. The current value of &UID will be requested when the DO procedure is executed. UID is particularly relevant when used in conjunction with the ACC parameter (see below). For instance, selected Account numbers from different Join entries can be saved together. The USER-ID= parameter is defined as a variable in the MODIFY-USER command. This procedure can thus be used later to enter particular Account numbers into different userids. For further information, see page .

userid The &UID parameter in the DO procedure will be substituted with the value specified: PROC A,(&UID=userid),SUBDTA=&.

AU The commands /ADD-USER ... /STEP will also be generated in the DO procedure under BS2000 V10 (as they are in BS2000 V11).

GR The membership of a Join entry to a particular User Group will be retained by the procedure (MODIFY-USER-GROUP ...,ADD-GROUP-MEMBER=userid command).

Standard: Group membership is not retained when the Save procedure is created.

ACC The DO procedure will be generated such that the BS2000 commands contain only the Account number information for restoring the Join entries.

Standard: The User- and Account-specific characteristics of the Join entries will normally be saved.

MAIL The DO procedure will be generated such that the BS2000 commands contain only the Mailing address information for restoring the Join entries.

Standard: The User- and Account-specific characteristics of the Join entries will normally be saved.

NPASS The DO procedure will be generated such that the existing Logon passwords will not be restored

PASS The DO procedure will be generated such that the BS2000 commands contain only the Logon password information for restoring the Join entries.

Standard: The User- and Account-specific characteristics of the Join entries will normally be saved.

LP The Logon Protection of the userid will be retained in the DO procedure (MODIFY-LOGON-PROTECTION command).

Standard: Logon Protection is not retained when the Save procedure is created.

POSIX The POSIX User attributes of the userid will be retained in the DO procedure (MODIFY-POSIX-USER-ATTRIBUTES command).

Standard: The POSIX User attributes will not normally be saved when the Save procedure is created.

SM The User Pubset attribute for SM pubsets of the userid will be retained in the DO procedure (MODIFY-USER-PUBSET-ATTRIBUTES command).

Standard: The User-Pubset attribute will not be retained when the Save procedure is created.

PRIV An Enter file containing commands for recreating the privilege levels of userids will be created.

The ONXSAVE ... ,PRIV Variable Action can only be applied to Join entries of a single pubset. Join entries from additional pubsets will be ignored.

Entering the PRIV parameter will always result in an Enter file being created. To recreate the privilege levels, the Enter file must be run under the SYSPRIV userid, since the commands may only be executed from this userid.

Standard: The privilege levels of the userids will not be taken into account when creating the procedure.

OPR An Enter file containing the commands necessary for recreating the Operator Roles of the userids will be created.

The ONXSAVE ... ,OPR Variable Action can only be applied to Join entries of a single pubset. Join entries from additional pubsets will be ignored.

Entering the OPR parameter will always result in an Enter file being created. To recreate the privilege levels, the Enter file must be run under the SYSPRIV userid, since the commands may only be executed from this userid.

Standard: The Operator Roles of the userids will not be taken into account when creating the procedure.

TSET Assigned Terminal Sets which are saved in the userids will be reflected in the DO procedure (CREATE-TERMINAL-SET procedure).

Standard: the Terminal Sets will not be taken into account.

NSTD The standard Join attributes will not be taken into account in the DO procedure. This operand allows, for example, only the Logon Protection attributes to be saved (...,LP,NSTD).

Notes:

To save all Join attributes, the Variable Action can be specified in the following format: ONXSAVE file,GR,LP,POSIX,SM

The procedure will also save entries for severed Join entries by first executing a MODIFY-USER command and then a LOCK-USER-ID command.

The DEFCAT, PVS, PUBSP and UID parameters can also be combined.

The PVS parameter is particularly useful if all Join entries from a particular pubset need to be created identically on another pubset.

The SAVE Variable Action will also process JOIN command parameters that are not catered for by SJMSAVE, such as the Account number Spool class (Parameter CLASS=) and the SEVER status of the Join entry (see the first note above).