Adding, Updating and Deleting a User Key with CA Roscoe

Products

• Roscoe

Issue/Introduction

 

To make minor additions, deletions or updates to user keys use UPS.UPSMNT60 from the ROSCOE.PROFILE (UPS) key or from any key which has UPS privileges.  To make bulk additions, use UPSBLK.

 

Resolution

Instructions: 

UPS.UPSMNT60 

CA-ROSCOE USER PROFILING SYSTEM ENTER SELECTION: ADD A NEW PROFILE UPDATE AN EXISTING PROFILE DELETE AN EXISTING PROFILE FOR ADD: ENTER PROTOTYPE KEY OR PFX (IF DESIRED) FOR UPDATE: ENTER KEY OR PFX TO BE UPDATED FOR DELETE: ENTER KEY OR PFX TO BE DELETED KEY: PFX: FKEY:

To add a key enter "1" on the "ENTER SELECTION" line and enter either a model prefix on the PFX line or the model key on the KEY line and hit enter.

CA-ROSCOE USER PROFILING SYSTEM ENTER SELECTION: 1 ADD A NEW PROFILE UPDATE AN EXISTING PROFILE DELETE AN EXISTING PROFILE FOR ADD: ENTER PROTOTYPE KEY OR PFX (IF DESIRED) FOR UPDATE: ENTER KEY OR PFX TO BE UPDATED FOR DELETE: ENTER KEY OR PFX TO BE DELETED KEY: PFX: ADX FKEY: PF3/PF15 TO END

Now change the USER KEY, PREFIX and optionally the FORMAL KEY. You may also optionally limit the number of lines the user may save in the Roscoe library and require the user to specify a Roscoe password. If you want the user to interface with other users, and be able to access and update other users Roscoe library members you may want to include this user in a security group. This is discussed in Section 4.8 of the Roscoe System Reference Guide. Privileged commands are discussed in the Roscoe System Reference Guide, page 4-10, and may alternately be given by security commands.

CA-ROSCOE USER PROFILING SYSTEM PROTOTYPE KEY: ASDS      MODE: ADD USER KEY: USER001 PREFIX: U01 FORMAL KEY: USER001 PASSWORD:      PASSWORD REQUIRED (Y/N): N ABLE TO CHANGE (Y/N): Y MAXIMUM LINES USER CAN SAVE: 00000000      CURRENT LINES SAVED: N/A SIGNON PROCEDURE:      ABLE TO CHANGE (Y/N): Y RESTRICTED USER (Y/N): N USER ABLE TO USE PRIVILEGED COMMANDS (Y/N): OPER: N   RPS:   N   ACCT:   N ETSO:   N   LIB:   N   UPS:   N LIBRARY SECURITY GROUP: MORE PROFILES TO ADD/UPDATE (Y/N): N PF1/13 BYPASS UPDATE    PF3/15 TERMINATE UPSMAINT

To update a key enter "2" on the "ENTER SELECTION" line and enter a valid prefix or user key and hit enter.

CA-ROSCOE USER PROFILING SYSTEM ENTER SELECTION: 2 ADD A NEW PROFILE UPDATE AN EXISTING PROFILE DELETE AN EXISTING PROFILE FOR ADD: ENTER PROTOTYPE KEY OR PFX (IF DESIRED) FOR UPDATE: ENTER KEY OR PFX TO BE UPDATED FOR DELETE: ENTER KEY OR PFX TO BE DELETED KEY: PFX: U01 FKEY: PF3/PF15 TO END

Change the selected fields - and hit enter again.

CA-ROSCOE USER PROFILING SYSTEM PROTOTYPE KEY: N/A      MODE: UPDATE USER KEY: USER001 PREFIX: U01 FORMAL KEY: USER001 PASSWORD:      PASSWORD REQUIRED (Y/N): N ABLE TO CHANGE (Y/N): Y MAXIMUM LINES USER CAN SAVE: 00100000      CURRENT LINES SAVED: 00000000 SIGNON PROCEDURE:      ABLE TO CHANGE (Y/N): Y RESTRICTED USER (Y/N): N USER ABLE TO USE PRIVILEGED COMMANDS (Y/N): OPER: N   RPS:   N   ACCT:   N ETSO:   N   LIB:   N   UPS:   N LIBRARY SECURITY GROUP: MORE PROFILES TO ADD/UPDATE (Y/N): N PF1/13 BYPASS UPDATE    PF3/15 TERMINATE UPSMAINT

To delete a key enter a "3" on the "ENTER SELECTION" line and enter a valid prefix or user key and hit enter. The user key will be deleted however the members may still be accessed.

CA-ROSCOE USER PROFILING SYSTEM ENTER SELECTION: 3 ADD A NEW PROFILE UPDATE AN EXISTING PROFILE DELETE AN EXISTING PROFILE FOR ADD: ENTER PROTOTYPE KEY OR PFX (IF DESIRED) FOR UPDATE: ENTER KEY OR PFX TO BE UPDATED FOR DELETE: ENTER KEY OR PFX TO BE DELETED KEY: PFX: U01 FKEY: UPM03 INVALID OPTION SELECTED: ENTER 1, 2, OR 3 PF3/PF15 TO END

Once the key has been deleted, the members can be deleted by using ROSMAILS as shown below:  Customize the name and numbers of the ROSLIBS.

//ROSMAILS EXEC PGM=ROSMAILS,REGION=4M,PARM='DELETE,LINECNT=56'
//STEPLIB DD DSN=xx.RO60LIB,DISP=SHR
//ROSLIB00 DD DSN=xx.ROSLIB00,DISP=SHR
//ROSLIB01 DD DSN=xx.ROSLIB01,DISP=SHR
//ROSLIB02 DD DSN=xx.ROSLIB02,DISP=SHR
//SORTLIB DD DSN=SYSx.SORTLIB,DISP=SHR
//SORTIN DD UNIT=SYSDA,SPACE=(TRK,(3,3)),
//      DCB=(LRECL=136,RECFM=FB,BLKSIZE=1360)
//SORTWK01 DD UNIT=SYSDA,SPACE=(TRK,5,,CONTIG)
//SORTWK02 DD UNIT=SYSDA,SPACE=(TRK,5,,CONTIG)
//SORTWK03 DD UNIT=SYSDA,SPACE=(TRK,5,,CONTIG)
//SORTWK04 DD UNIT=SYSDA,SPACE=(TRK,5,,CONTIG)
//SORTWK05 DD UNIT=SYSDA,SPACE=(TRK,5,,CONTIG)
//SORTWK06 DD UNIT=SYSDA,SPACE=(TRK,5,,CONTIG)
//SYSOUT DD SYSOUT=*
//SYSPRINT DD SYSOUT=*
//REPORT DD SYSOUT=*,DCB=(LRECL=121,RECFM=FBA,BLKSIZE=2420)
//SYSWARN DD SYSOUT=*,DCB=(LRECL=121,RECFM=FBA,BLKSIZE=2420)
//SYSIN DD DUMMY

UPSBLK60  Modifying Keys in bulk

When there are a number of keys to modify, it is sometimes easier to create update instructions in the AWS and execute UPSBLK60.

If new user keys are to be defined, a default model key should first be defined. There are provisions for defining it in stream.

UPSBLK60 expects each profile to be added, updated or deleted to be in the active AWS and start with a BEGIN statement and terminate with an END statement. Both the BEGIN and END statement must start in column 1.

A sample input stream to add, update and delete members follows:

BEGIN ADD KEY=UTEST00
   PREFIX=UT0
END
BEGIN DEFAULT KEY=UTEST00
END
BEGIN ADD KEY=UTEST01
   PREFIX=UT1
END
BEGIN ADD KEY=UTEST02
   PREFIX=UT2
END
BEGIN CHANGE KEY=UTEST02
   MAX=10000
END
BEGIN DELETE KEY=UTEST01
END

Notes:

1. The first set of BEGIN - END statements adds key UTEST00.
2. The second set of BEGIN - END statements sets key UTEST00 as a profile key.
3. The third set of BEGIN - END statements adds key UTEST01.
4. The fourth set of BEGIN - END statements adds key UTEST02.
5. The fifth set of BEGIN - END statements changes key UTEST02 to have a max 10000 lines.
6. The sixth set of BEGIN - END statements deletes key UTEST01.

 

Additional Information

Additional Information:

See Section 4.2 Creating and Maintaining User Profiles in the Roscoe System Reference Guide.