Adding, Updating and Deleting a User Key with CA Roscoe

Document ID : KB000028222
Last Modified Date : 14/02/2018
Show Technical Document Details

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.

Instructions: 

UPS.UPSMNT60 


CA-ROSCOE USER PROFILING SYSTEM
ENTER SELECTION:

  1. ADD A NEW PROFILE
  2. UPDATE AN EXISTING PROFILE
  3. 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

        1. ADD A NEW PROFILE
        2. UPDATE AN EXISTING PROFILE
        3. 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 CA Roscoe System Reference Guide. Privileged commands are discussed in the CA 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

              1. ADD A NEW PROFILE
              2. UPDATE AN EXISTING PROFILE
              3. 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

                    1. ADD A NEW PROFILE
                    2. UPDATE AN EXISTING PROFILE
                    3. 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=CA.RO60LIB,DISP=SHR
                            //ROSLIB00 DD DSN=CA.ROSLIB00,DISP=SHR
                            //ROSLIB01 DD DSN=CA.ROSLIB01,DISP=SHR
                            //ROSLIB02 DD DSN=CA.ROSLIB02,DISP=SHR
                            //SORTLIB DD DSN=SYS1.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:

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