The CRTDUPOBJ (Create Duplicate Object) command does not offer a replace option. If the object already exists, the command is ended and an error message is sent. Having to delete an object before each copy can be very annoying, so I created the Copy Object (CPYOBJ) command which gets around this problem.

The CPYOBJ command (2a) accepts the required parameters to run CRTDUPOBJ, with one additional parameter: REPLACE. The RE-PLACE parameter has three choices: *NO, which never replaces an existing object. If the object does not exist *NO is ignored and the object is created. If it does exist, an error message is sent and the command ends. *YES always replaces an existing object. The object is replaced and a completion message is sent. With *WARN, a warning message requiring a reply is sent using SNDUSRMSG. Either Y or N to the response sends a message to the user. For the parameter OBJTYPE I have included 10 of the most common object types. This parameter may be modified to accept others not listed. You must also include delete commands for any additional objects in program OBJ001CL.

The CPYOBJ command (Figure 2a) accepts the required parameters to run CRTDUPOBJ, with one additional parameter: REPLACE. The RE-PLACE parameter has three choices: *NO, which never replaces an existing object. If the object does not exist *NO is ignored and the object is created. If it does exist, an error message is sent and the command ends. *YES always replaces an existing object. The object is replaced and a completion message is sent. With *WARN, a warning message requiring a reply is sent using SNDUSRMSG. Either Y or N to the response sends a message to the user. For the parameter OBJTYPE I have included 10 of the most common object types. This parameter may be modified to accept others not listed. You must also include delete commands for any additional objects in program OBJ001CL.

In OBJ001CL program (2b), I receive the object and library names as a qualified parameter. It is necessary to split this variable up later in the program using CHGVAR and the substring function. This is because CRTDUPOBJ has object and library as two parameters. I check the current library with RTVJOBA (Retrieve Job Attributes) to determine if a current library is in the library list. If it is not, I default to library QGPL. I next attempt to perform CRTDUPOBJ. I monitor for escape messages such as, library not found or object not found. If the command is successful, I send a completion message. If the object already exists, I check which replace option was picked, and take the appropriate action mentioned earlier. If the *WARN option is taken, I delete the object and process the CRTDUPOBJ once again.

In OBJ001CL program (Figure 2b), I receive the object and library names as a qualified parameter. It is necessary to split this variable up later in the program using CHGVAR and the substring function. This is because CRTDUPOBJ has object and library as two parameters. I check the current library with RTVJOBA (Retrieve Job Attributes) to determine if a current library is in the library list. If it is not, I default to library QGPL. I next attempt to perform CRTDUPOBJ. I monitor for escape messages such as, library not found or object not found. If the command is successful, I send a completion message. If the object already exists, I check which replace option was picked, and take the appropriate action mentioned earlier. If the *WARN option is taken, I delete the object and process the CRTDUPOBJ once again.

-- Michael Gariola

Techtalk: Copying Objects

Figure 2A Command CPYOBJ

 CPYOBJ: CMD PROMPT('Copy Object to Another Library') PARM KWD(OBJ) TYPE(NAME1) MIN(1) PROMPT('Name of + Object') PARM KWD(OBJTYPE) TYPE(*CHAR) LEN(7) RSTD(*YES) + VALUES(*CMD *DTAARA *FILE *JOBD *MSGF + *MSGQ *OUTQ *PGM *QRYDFN *SBSD) MIN(1) + PROMPT('Object type') PARM KWD(TOLIB) TYPE(*SNAME) LEN(10) DFT(*SAME) + SPCVAL((*SAME)) PROMPT('To library') PARM KWD(NEWOBJ) TYPE(*SNAME) LEN(10) DFT(*SAME) + SPCVAL((*SAME)) PROMPT('Name of new object') PARM KWD(REPLACE) TYPE(*CHAR) LEN(5) RSTD(*YES) + DFT(*WARN) VALUES(*NO *YES *WARN) + PROMPT('Replace') NAME1: QUAL TYPE(*SNAME) LEN(10) MIN(1) QUAL TYPE(*SNAME) LEN(10) DFT(*CURLIB) + SPCVAL((*CURLIB)) PROMPT('Library') 
 
 Techtalk: Copying Objects
 
 Figure 2B CL program OBJ001CL
 
 OBJ001CL: + PGM PARM(&QLFNAM &OBJTYPE &TOLIB &NEWOBJ &REPLACE) DCL VAR(&QLFNAM) TYPE(*CHAR) LEN(20) DCL VAR(&OBJ) TYPE(*CHAR) LEN(10) DCL VAR(&FROMLIB) TYPE(*CHAR) LEN(10) DCL VAR(&OBJTYPE) TYPE(*CHAR) LEN(7) DCL VAR(&TOLIB) TYPE(*CHAR) LEN(10) DCL VAR(&NEWOBJ) TYPE(*CHAR) LEN(10) DCL VAR(&REPLACE) TYPE(*CHAR) LEN(5) DCL VAR(&DATA) TYPE(*CHAR) LEN(4) VALUE(*NO) DCL VAR(&MSGRPY) TYPE(*CHAR) LEN(1) DCL VAR(&MSGID) TYPE(*CHAR) LEN(7) DCL VAR(&MSGDTA) TYPE(*CHAR) LEN(100) DCL VAR(&MSGF) TYPE(*CHAR) LEN(10) DCL VAR(&MSGFLIB) TYPE(*CHAR) LEN(10) DCL VAR(&CURLIB) TYPE(*CHAR) LEN(10) CHGVAR VAR(&OBJ) VALUE(%SST(&QLFNAM 1 10)) CHGVAR VAR(&FROMLIB) VALUE(%SST(&QLFNAM 11 10)) RTVJOBA CURLIB(&CURLIB) IF COND(&CURLIB *EQ '*NONE') THEN(CHGVAR VAR(&CURLIB) VALUE(QGPL)) IF COND(&FROMLIB *EQ '*CURLIB') THEN(CHGVAR VAR(&FROMLIB) + VALUE(&CURLIB)) IF COND(&TOLIB *EQ '*SAME') THEN(CHGVAR VAR(&TOLIB) + VALUE(&FROMLIB)) IF COND(&NEWOBJ *EQ '*SAME') THEN(CHGVAR VAR(&NEWOBJ) VALUE(&OBJ)) IF COND(&OBJTYPE *EQ '*FILE') THEN(CHGVAR VAR(&DATA) VALUE(*YES)) CREATE: + CRTDUPOBJ OBJ(&OBJ) FROMLIB(&FROMLIB) OBJTYPE(&OBJTYPE) + TOLIB(&TOLIB) NEWOBJ(&NEWOBJ) DATA(&DATA) MONMSG MSGID(CPF0000) EXEC(DO) RCVMSG MSGTYPE(*ANY) MSGDTA(&MSGDTA) MSGID(&MSGID) + MSGF(&MSGF) MSGFLIB(&MSGFLIB) IF COND(&MSGID *EQ 'CPF2110' *OR &MSGID *EQ 'CPF2105' *OR + &MSGID *EQ 'CPF2182' *OR &MSGID *EQ 'CPF2189') THEN(GOTO + CMDLBL(MSG)) IF COND(&MSGID *EQ 'CPD2104') THEN(GOTO CMDLBL(DELETE)) ENDDO SNDPGMMSG MSG('Object' *BCAT &NEWOBJ *BCAT 'in' *BCAT &TOLIB + *BCAT 'type' *BCAT &OBJTYPE *BCAT 'created.') MSGTYPE(*COMP) RETURN DELETE: + IF COND(&TOLIB *EQ &FROMLIB *AND &NEWOBJ *EQ &OBJ) THEN(GOTO + CMDLBL(MSG)) IF COND(&REPLACE *EQ '*NO') THEN(GOTO CMDLBL(MSG)) IF COND(&REPLACE *EQ '*YES') THEN(GOTO CMDLBL(REPYES)) SNDUSRMSG MSG('Do you wish to delete' *BCAT &NEWOBJ *BCAT '? (Y + N).') VALUES(Y N) DFT(N) MSGTYPE(*INQ) MSGRPY(&MSGRPY) IF COND(&MSGRPY *EQ 'Y') THEN(DO) REPYES: + IF COND(&OBJTYPE *EQ '*CMD') THEN(DLTCMD CMD(&TOLIB/&NEWOBJ)) IF COND(&OBJTYPE *EQ '*DTAARA') THEN(DLTDTAARA + DTAARA(&TOLIB/&NEWOBJ)) IF COND(&OBJTYPE *EQ '*FILE') THEN(DLTF FILE(&TOLIB/&NEWOBJ)) IF COND(&OBJTYPE *EQ '*JOBD') THEN(DLTJOBD JOBD(&TOLIB/&NEWOBJ)) IF COND(&OBJTYPE *EQ '*MSGF') THEN(DLTMSGF MSGF(&TOLIB/&NEWOBJ)) IF COND(&OBJTYPE *EQ '*OUTQ') THEN(DLTOUTQ OUTQ(&TOLIB/&NEWOBJ)) IF COND(&OBJTYPE *EQ '*PGM') THEN(DLTPGM PGM(&TOLIB/&NEWOBJ)) IF COND(&OBJTYPE *EQ '*QRYDFN') THEN(DLTQRY QRY(&TOLIB/&NEWOBJ)) IF COND(&OBJTYPE *EQ '*SBSD') THEN(DLTSBSD SBSD(&TOLIB/&NEWOBJ)) GOTO CMDLBL(CREATE) ENDDO SNDPGMMSG MSG('Object' *BCAT &NEWOBJ *BCAT 'not deleted.') + MSGTYPE(*COMP) GOTO CMDLBL(END) MSG: + SNDPGMMSG MSGID(&MSGID) MSGF(&MSGFLIB/&MSGF) MSGDTA(&MSGDTA) + MSGTYPE(*ESCAPE) END: + ENDPGM