CL Command Reference - ADDCRQA
CL Command List > ADDCRQA Reference
Description:
The Add Change Request Activity (ADDCRQA) command adds a change management activity to a change request description. The change management action that is to be performed by the added activity depends on the value specified on the action parameter.
The activity can be conditioned so that it will only run after one or more other activities have completed (successfully or unsuccessfully). The activity may also be scheduled to run at a date and time in the future.
Restrictions:
. You must have *CHANGE authority to the change request description object and *EXECUTE authority to the library.
. If a node list (NODL) value is specified, the node list can only contain entries that have a value of *SNA for the address type.
. Global names or component names must be 64 characters or less including one separator character between tokens.
Note: If you need to cancel an installation of a NetView Distribution Manager (NetView DM) change file or other non-i5/OS object, you must use the Add Change Management Activity (QNSADDCM) API.
Examples:
The following examples illustrate how to use the ADDCRQA command to schedule activities to be performed on managed systems controlled by a NetView Distribution Manager/6000 change control server. The examples shown here are grouped according to their activity action:
. Accept
. Activate
. Delete
. Run
. Install
. Remove
. Retrieve
. Send, send and run, send and install
. Uninstall
Example 1: Accept Actions The examples shown here match those shown for the install examples and demonstrate how some of the installed objects can be accepted.
. The install activity added to the change request description is:
ADDCRQA CRQD(CCLIB/CRQACPRMV) ACTIVITY(INSACT01) ACTION(*INS)
GLBNAME(IBM 1234567 PMGRAB UPD 1 2)
CPNAME((ROMSERV1 MARYPWS1)) ACTUSEINS(*TRIAL)
ALWRMV(*YES)
When the change request is submitted and if the activity is run successfully, object IBM 1234567 PMGRAB UPD 1 2 is installed (to be tested) in the trial area of managed system MARYPWS1. MARYPWS1 is controlled by the change control server ROMSERV1. Because the object is installed in the trial area, the object cannot be accepted.
. The install activity added to the change request description is:
ADDCRQA CRQD(CCLIB/CRQACPRMV) ACTIVITY(INSACT02)
ACTION(*INS) GLBNAME(IBM 1234567 PMGRAB UPD 1 2)
CPNAME((ROMSERV1 MARYPWS1)) ACTUSEINS(*PROD)
ALTACTCOMP(*ALLOWED) ALWRMV(*NO)
RMTSTRTIME((*MGDSYS) (8:30:00 12/25/02))
When the change request is submitted and if the activity is successfully run, object IBM 1234567 PMGRAB UPD 1 2 is installed in the active area of the system MARYPWS1. MARYPWS1 is managed by the change control server ROMSERV1. The object is installed in a nonremovable manner, and thus, the object does not need to be accepted.
. The install activity added to the change request description is:
ADDCRQA CRQD(CCLIB/CRQACPRMV) ACTIVITY(INSACT03)
ACTION(*INS) GLBNAME(IBM 1234567 PMGRAB UPD 1 2)
CPNAME((ROMSERV1 MARYPWS1))
COREQCHGNL((REXX PROC UPDATE CONFIG))
ACTUSEINS(*PROD) ALTACTCOMP(*NOTALLOWED)
AUTOACP((*YES)) ALWRMV(*YES)
The objects are automatically accepted with a required activation if the following conditions are met:
¨C The change request is submitted
¨C The activity runs successfully
¨C The installation completes successfully (the object IBM 1234567 PMGRAB UPD 1 2 and its corequisite REXX PROC UPDATE CONFIG were installed successfully)
If the installation did not complete successfully, the objects IBM 1234567 PMGRAB UPD 1 2 and REXX PROC UPDATE CONFIG are not automatically accepted. You can accept the objects running the following activities:
ADDCRQA CRQD(CCLIB/CRQACPRMV) ACTIVITY(ACCACT01)
ACTION(*ACP) GLBNAME(IBM 1234567 PMGRAB UPD 1 2)
CPNAME((ROMSERV1 MARYPWS1))
COND((INSACT03 *EQ 20 *SAMENODE))
ADDCRQA CRQD(CCLIB/CRQACPRMV) ACTIVITY(ACCACT02)
ACTION(*ACP) GLBNAME(REXX PROC UPDATE CONFIG)
CPNAME((ROMSERV1 MARYPWS1))
COND((INSACT03 *EQ 20 *SAMENODE))
. The install activity added to the change request description is:
ADDCRQA CRQD(CCLIB/CRQACPRMV) ACTIVITY(INSACT04)
ACTION(*INS) GLBNAME(EURO WORDPROD UPD 2 3 US)
CPNAME((EUROITAL FREDSWS)) ALWRMV(*YES)
When the change request is submitted and if the activity is run successfully, an object is installed in a removable manner. The object can be accepted adding an activity to accept the previously installed object EURO WORDPROD UPD 2 3 US on managed system FREDSWS. Managed system FREDSWS is controlled by the change control server EUROITAL.
ADDCRQA CRQD(CCLIB/CRQACPRMV) ACTIVITY(ACCACT03)
ACTION(*ACP) GLBNAME(EURO WORDPROD UPD 2 3 US)
CPNAME((EUROITAL FREDSWS))
COND((INSACT04 *EQ *SUCCESS *SAMENODE))
Example 2: Activate Actions
. It is assumed that an install activity was issued as follows:
ADDCRQA CRQD(CCLIB/CRQINSACT) ACTIVITY(INSACT01)
ACTION(*INS) GLBNAME(IBM 1234567 PMGRAB UPD 1 2)
CPNAME((ROMSERV1 MARYPWS1)) ACTUSEINS(*PROD)
ALTACTCOMP(*NOTALLOWED) AUTOACP(*YES)
COREQCHGNL((REXX PROC UPDATE CONFIG))
. When the change request is submitted and if the activity is run successfully, objects IBM 1234567 PMGRAB UPD 1 2 and REXX PROC UPDATE CONFIG are automatically accepted. To apply the component alterations to the active system, an activation is required. To activate previously installed changes, run an activity like the following:
ADDCRQA CRQD(CCLIB/CRQINSACT) ACTIVITY(ACTACT01)
ACTION(*ACT) CPNAME((ROMSERV1 MARYPWS1))
ACTFRC(*NO *HOURS 6) ACTUSEACT(*PROD)
STRTIME((2:00:00 *NEXT) (8:00:00 *NEXT))
The activation will occur after 2 a.m. but before 8 a.m. the next morning the request is submitted. The MARYPWS1 system waits up to six hours before proceeding with the activation if the managed system is still active.
. Add an activity to schedule the activation of all previously installed objects on managed system FREDSWS. FREDSWS is controlled by the change control server EUROITAL. The activation occurs as soon as possible after 11 p.m. on 15 April 2002 in the time zone where FREDSWS is located. The activation occurs even if the managed system FREDSWS is still active.
ADDCRQA CRQD(CCLIB/CRQINSACT) ACTIVITY(ACTACT02)
ACTION(*ACT) CPNAME((EUROITAL FREDSWS))
ACTFRC(*YES) RMTSTRTIME(*MGDSYS (23:00:00 04/15/02))
Example 3: Delete Actions
. Add an activity to delete the object EURO WORDPROD UPD 2 3 US on managed system FREDSWS. FREDSWS is controlled by the change control server EUROITAL.
ADDCRQA CRQD(CCLIB/CRQDLT) ACTIVITY(DLTACT01)
ACTION(*DLT) GLBNAME(EURO WORDPROD UPD 2 3 US)
CPNAME((EUROITAL FREDSWS))
. Add an activity to delete all test files from systems MARYPWS1, MARYPWS2, MARYPWS3, and MARYPWS4. These systems are controlled by the change control server ROMSERV1. The test files on these systems are cataloged as EURO SPELLCHECK TEST file-name.
ADDCRQA CRQD(CCLIB/CRQSNDDLT) ACTIVITY(DLTACT01)
ACTION(*DLT) GLBNAME(EURO SPELLCHECK TEST *ANY)
CPNAME((ROMSERV1 MARYPWS1) (ROMSERV1 MARYPWS2)
ROMSERV1 MARYPWS3) (ROMSERV1 MARYPWS4))
COND((SNDACT01 *EQ *SUCCESS *ALLNODES))
The delete activity is performed only if the object EURO SPELLCHECK EXE 1 US is successfully sent to those systems:
ADDCRQA CRQD(CCLIB/CRQSNDDLT) ACTIVITY(SNDACT01)
ACTION(*SND) GLBNAME(EURO SPELLCHECK EXE 1 US)
CPNAME((ROMSERV1 MARYPWS1) (ROMSERV1 MARYPWS2)
(ROMSERV1 MARYPWS3) (ROMSERV1 MARYPWS4))
REPLACE(*ALLOWED)
Example 4: Run Actions
. Add an activity to run the program or script known by the global name EURO VIRUSCHK EXE 1 US on managed system FREDSWS. Pass the parameter /usr/bin to the program or script. The activity is run as soon as possible.
ADDCRQA CRQD(CCLIB/CRQRUN) ACTIVITY(RUNACT01)
ACTION(*RUN) GLBNAME(EURO VIRUSCHK EXE 1 US)
CPNAME((EUROITAL FREDSWS)) PARM(("/usr/bin"))
. Add an activity to run the program known by the global name EURO WORDPROC EXE 2 US on managed system JOHNSWS. This activity should be run immediately by the PS/2. The object should be kept in the NetView/DM2 catalog. The change control server is in the same network as the local system.
ADDCRQA CRQD(CCLIB/CRQRUN) ACTIVITY(RUNACT02)
ACTION(*RUN) GLBNAME(EURO WORDPROC EXE 2 US)
CPNAME((*NETATR JOHNSWS)) KEEPOBJ(*YES)
Example 5: Install Actions
The first four examples shown here match those shown for the accept and remove examples.
. Add an activity to install the object identified by the global name IBM 1234567 PMGRAB UPD 1 2 on the change control client machine (managed system) called MARYPWS1. MARYPWS1 is controlled by the change control server ROMSERV1. The object is to be installed in the trial area.
ADDCRQA CRQD(CCLIB/CRQACPRMV) ACTIVITY(INSACT01)
ACTION(*INS) GLBNAME(IBM 1234567 PMGRAB UPD 1 2)
CPNAME((ROMSERV1 MARYPWS1)) ACTUSEINS(*TRIAL)
ALWRMV(*YES)
. Add an activity to install the object identified by the global name IBM 1234567 PMGRAB UPD 1 2 on the change control client machine (managed system) called MARYPWS1. MARYPWS1 is controlled by the change control server ROMSERV1. The object is to be installed permanently in the active area. The activity is to be processed at 8:30 a.m. on 25 December 2002.
ADDCRQA CRQD(CCLIB/CRQACPRMV) ACTIVITY(INSACT02)
ACTION(*INS) GLBNAME(IBM 1234567 PMGRAB UPD 1 2)
CPNAME((ROMSERV1 MARYPWS1)) ACTUSEINS(*PROD)
ALTACTCOMP(*ALLOWED) ALWRMV(*NO)
RMTSTRTIME((*MGDSYS) (8:30:00 12/25/02))
. Add an activity to install the objects identified by the global names IBM 1234567 PMGRAB UPD 1 2 and its corequisite REXX PROC UPDATE CONFIG on the change control client (managed system) MARYPWS1. MARYPWS1 is controlled by the change control server ROMSERV1. The objects are to be installed in a nonremovable manner and are to be automatically accepted. An activation is required to apply the component alterations to the active system. The activity is to be processed immediately. If the installation of one of the objects fails, the other installation fails also.
ADDCRQA CRQD(CCLIB/CRQACPRMV) ACTIVITY(INSACT03)
ACTION(*INS) GLBNAME(IBM 1234567 PMGRAB UPD 1 2)
CPNAME((ROMSERV1 MARYPWS1)) ACTUSEINS(*PROD)
ALTACTCOMP(*NOTALLOWED) AUTOACP((*YES)) ALWRMV(*YES)
COREQCHGNL((REXX PROC UPDATE CONFIG))
. Add an activity to install the object identified by the global name EURO WORDPROD UPD 2 3 US on the change control client machine (managed system) called FREDSWS. FREDSWS is controlled by the change control server EUROITAL. The object is to be installed in a removable manner.
ADDCRQA CRQD(CCLIB/CRQACPRMV) ACTIVITY(INSACT04)
ACTION(*INS) GLBNAME(EURO WORDPROD UPD 2 3 US)
CPNAME((EUROITAL FREDSWS)) ALWRMV(*YES)
. Add an activity to schedule the install of the objects EURO.WORDPROC.REF.2.US and EURO.WORDPROC.UPD.2.3.US on managed system FREDSWS. FREDSWS is controlled by the change control server EUROITAL. The object is installed in the active area in a removable manner. The installation is not automatically accepted. The installation is scheduled for 3 p.m. on 1 January 2003.
ADDCRQA CRQD(CCLIB/CRQRTVINS) ACTIVITY(INSACT05)
ACTION(*INS) GLBNAME(EURO WORDPROC REF 2 US)
CPNAME((EUROITAL FREDSWS)) ALTACTCOMP(*ALLOWED)
COREQCHGNL(EURO WORDPROC UPD 2 3 US)
RMTSTRTIME(*MGDSYS (15:00:00 1/01/03))
COND((RTVACT01 *EQ *SUCCESS *ALLNODES))
. Add an activity to install the object identified by the global name IBM 1234567 WINDMB UPD 1 2 on the production area of managed system MARYPWS1. If the installation fails, the object is removed automatically.
ADDCRQA CRQD(CCLIB/CRQINS) ACTIVITY(INSACT06)
ACTION(*INS) GLBNAME(IBM 1234567 WINDMB UPD 1 2)
CPNAME((ROMSERV1 MARYPWS1)) ACTUSEINS(*PROD)
AUTORMV(*YES) ALWRMV(*YES)