Change CRQ Activity (CHGCRQA)
| Where allowed to run: All environments (*ALL) Threadsafe: No |
Parameters Examples Error messages |
The Change Change Request Activity (CHGCRQA) command modifies 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 can also be scheduled to run at a date and time in the future.
Restrictions
- The user must have *CHANGE authority to the change request description object and *EXECUTE authority to the library.
- If a NODL value is specified, the node list can only contain entries that have a value of *SNA for the address type.
- Global names must be 64 characters or less including one separator character between tokens.
| Top |
Parameters
| Keyword | Description | Choices | Notes |
|---|---|---|---|
| CRQD | Change request description | Qualified object name | Required, Key, Positional 1 |
| Qualifier 1: Change request description | Name | ||
| Qualifier 2: Library | Name, *LIBL, *CURLIB | ||
| ACTIVITY | Activity | Name, *LAST | Optional, Key, Positional 2 |
| ACTION | Action | *ACP, *ACT, *DLT, *INS, *RMV, *RTV, *RUN, *SND, *SNDINS, *SNDRUN, *UNINS, *SAME | Optional, Positional 3 |
| GLBNAME | Global name | Single values: *SAME Other values: Element list |
Optional |
| Element 1: Global name token 1 | Character value, *NETID, *SERVER, *TARGET, *MDDATE, *MDTIME | ||
| Element 2: Global name token 2 | Character value, *ANY, *HIGHEST, *LOWEST, *NETID, *CPNAME, *SERVER, *TARGET, *MDDATE, *MDTIME | ||
| Element 3: Global name token 3 | Character value, *ANY, *HIGHEST, *LOWEST, *NETID, *CPNAME, *SERVER, *TARGET, *MDDATE, *MDTIME | ||
| Element 4: Global name token 4 | Character value, *ANY, *HIGHEST, *LOWEST, *NETID, *CPNAME, *SERVER, *TARGET, *MDDATE, *MDTIME | ||
| Element 5: Global name token 5 | Character value, *ANY, *HIGHEST, *LOWEST, *NETID, *CPNAME, *SERVER, *TARGET, *MDDATE, *MDTIME | ||
| Element 6: Global name token 6 | Character value, *ANY, *HIGHEST, *LOWEST, *NETID, *CPNAME, *SERVER, *TARGET, *MDDATE, *MDTIME | ||
| Element 7: Global name token 7 | Character value, *ANY, *HIGHEST, *LOWEST, *NETID, *CPNAME, *SERVER, *TARGET, *MDDATE, *MDTIME | ||
| Element 8: Global name token 8 | Character value, *ANY, *HIGHEST, *LOWEST, *NETID, *CPNAME, *SERVER, *TARGET, *MDDATE, *MDTIME | ||
| Element 9: Global name token 9 | Character value, *ANY, *HIGHEST, *LOWEST, *NETID, *CPNAME, *SERVER, *TARGET, *MDDATE, *MDTIME | ||
| Element 10: Global name token 10 | Character value, *ANY, *HIGHEST, *LOWEST, *NETID, *CPNAME, *SERVER, *TARGET, *MDDATE, *MDTIME | ||
| COMPNAME | Component name | Single values: *SAME Other values: Element list |
Optional |
| Element 1: Component name token 1 | Character value, *NETID | ||
| Element 2: Component name token 2 | Character value, *NETID, *CPNAME | ||
| Element 3: Component name token 3 | Character value, *NETID, *CPNAME | ||
| Element 4: Component name token 4 | Character value, *NETID, *CPNAME | ||
| Element 5: Component name token 5 | Character value, *NETID, *CPNAME | ||
| Element 6: Component name token 6 | Character value, *NETID, *CPNAME | ||
| Element 7: Component name token 7 | Character value, *NETID, *CPNAME | ||
| NODL | Managed systems node list | Element list | Optional |
| Element 1: Node list |
Single values: *NONE, *SAME Other values: Qualified object name |
||
| Qualifier 1: Node list | Name | ||
| Qualifier 2: Library | Name, *LIBL, *CURLIB | ||
| CPNAME | Managed system node names | Single values: *NONE, *SAME Other values (up to 50 repetitions): Element list |
Optional |
| Element 1: Network identifier | Communications name, *NETATR | ||
| Element 2: Control point | Character value | ||
| TEXT | Text 'description' | Character value, *GEN, *BLANK, *SAME | Optional |
| ACTFRC | Activation force | Single values: *SAME, *YES Other values: Element list |
Optional |
| Element 1: Activation force | *NO | ||
| Element 2: Delay units | *SECONDS, *MINUTES, *HOURS | ||
| Element 3: Delay period | 1-65535 | ||
| ACTUSEACT | Activation use on activate | *BOTH, *PROD, *LAST, *NONE, *SAME | Optional |
| CPRTYPE | Compression type | *ADAPTIVE, *SNA, *USER, *NONE, *SAME | Optional |
| SNACPRCHR | SNA compression character | Hexadecimal value, *BLANK | Optional |
| USRCPRINF | User compression information | Element list | Optional |
| Element 1: User compression name | Name | ||
| Element 2: User parameters | Character value | ||
| CPRSTGSTT | Compression storage state | *DECOMPRESS, *COMPRESS, *NONE, *SAME | Optional |
| CPRTFRSTT | Compression transfer state | *DECOMPRESS, *COMPRESS, *NONE, *SAME | Optional |
| ACTUSEINS | Activation use on install | *PROD, *TRIAL, *SAME | Optional |
| ALTACTCOMP | Alter active components | *ALLOWED, *NOTALLOWED, *NONE, *SAME | Optional |
| AUTOACP | Auto accept | Single values: *SAME, *NONE, *NO Other values: Element list |
Optional |
| Element 1: Auto accept | *YES, *DESIRED | ||
| Element 2: Delay days | 0-255 | ||
| AUTORMV | Auto remove | *YES, *NO, *DESIRED, *NONE, *SAME | Optional |
| PRETEST | Pre test | *YES, *NO, *DESIRED, *SAME | Optional |
| POSTTEST | Post test | *YES, *NO, *DESIRED, *SAME | Optional |
| ALWRMV | Allow remove | *NO, *DESIRED, *YES, *SAME | Optional |
| PARM | Initiate parameters | Values (up to 40 repetitions): Not restricted | Optional |
| KEEPOBJ | Keep object | *YES, *NO, *NONE, *SAME | Optional |
| COREQCHGNL | Corequisite change name list | Single values: *NONE, *SAME Other values: Element list |
Optional |
| Element 1: Global name | Values (up to 6 repetitions): Element list | ||
| Element 1: Global name token 1 | Character value | ||
| Element 2: Global name token 2 | Character value | ||
| Element 3: Global name token 3 | Character value | ||
| Element 4: Global name token 4 | Character value | ||
| Element 5: Global name token 5 | Character value | ||
| Element 6: Global name token 6 | Character value | ||
| Element 7: Global name token 7 | Character value | ||
| Element 8: Global name token 8 | Character value | ||
| Element 9: Global name token 9 | Character value | ||
| Element 10: Global name token 10 | Character value | ||
| REPLACE | Replace object | *YES, *ALLOWED, *NO, *SAME | Optional |
| TODLTNAME | To be deleted name | Single values: *NONE, *SAME Other values: Element list |
Optional |
| Element 1: To be deleted name token 1 | Character value, *NETID, *SERVER, *TARGET, *MDDATE, *MDTIME | ||
| Element 2: To be deleted name token 2 | Character value, *ANY, *HIGHEST, *LOWEST, *NETID, *CPNAME, *SERVER, *TARGET, *MDDATE, *MDTIME | ||
| Element 3: To be deleted name token 3 | Character value, *ANY, *HIGHEST, *LOWEST, *NETID, *CPNAME, *SERVER, *TARGET, *MDDATE, *MDTIME | ||
| Element 4: To be deleted name token 4 | Character value, *ANY, *HIGHEST, *LOWEST, *NETID, *CPNAME, *SERVER, *TARGET, *MDDATE, *MDTIME | ||
| Element 5: To be deleted name token 5 | Character value, *ANY, *HIGHEST, *LOWEST, *NETID, *CPNAME, *SERVER, *TARGET, *MDDATE, *MDTIME | ||
| Element 6: To be deleted name token 6 | Character value, *ANY, *HIGHEST, *LOWEST, *NETID, *CPNAME, *SERVER, *TARGET, *MDDATE, *MDTIME | ||
| Element 7: To be deleted name token 7 | Character value, *ANY, *HIGHEST, *LOWEST, *NETID, *CPNAME, *SERVER, *TARGET, *MDDATE, *MDTIME | ||
| Element 8: To be deleted name token 8 | Character value, *ANY, *HIGHEST, *LOWEST, *NETID, *CPNAME, *SERVER, *TARGET, *MDDATE, *MDTIME | ||
| Element 9: To be deleted name token 9 | Character value, *ANY, *HIGHEST, *LOWEST, *NETID, *CPNAME, *SERVER, *TARGET, *MDDATE, *MDTIME | ||
| Element 10: To be deleted name token 10 | Character value, *ANY, *HIGHEST, *LOWEST, *NETID, *CPNAME, *SERVER, *TARGET, *MDDATE, *MDTIME | ||
| REFLVL | Refresh level | Character value, *SAME | Optional |
| FRCUNINS | Force uninstall | *YES, *NO, *SAME | Optional |
| RMTSTRTIME | Start time on managed system | Single values: *NONE Other values: Element list |
Optional |
| Element 1: Time zone | *LCLSYS, *MGDSYS, *SAME | ||
| Element 2: Start after | Element list | ||
| Element 1: Time | Time, *CURRENT, *SAME | ||
| Element 2: Date | Date, *CURRENT, *NEXT, *SAME | ||
| COND | Activity conditions | Single values: *NONE, *SAME Other values (up to 5 repetitions): Element list |
Optional |
| Element 1: Activity | Generic name, name, *PRV | ||
| Element 2: Relational operator | *EQ, *GT, *LT, *LE, *NE, *GE | ||
| Element 3: End code | 0-99, *SUCCESS, *FAIL, *NOTRUN, *ANY | ||
| Element 4: Condition mode | *ALLNODES, *SAMENODE | ||
| STRTIME | Activity start time | Element list | Optional |
| Element 1: Start after | Element list | ||
| Element 1: Time | Time, *CURRENT, *SAME | ||
| Element 2: Date | Date, *CURRENT, *NEXT, *SAME | ||
| Element 2: Start before | Element list | ||
| Element 1: Time | Time, *ANY, *CURRENT, *SAME | ||
| Element 2: Date | Date, *ANY, *CURRENT, *NEXT, *SAME | ||
| HOLD | Hold activity | *NO, *YES, *SAME | Optional |
| Top |
Change request description (CRQD)
Change request description object name.
The possible values are:
- *LIBL
- All of the libraries in the user and system portions of the job's library list are searched.
- *CURLIB
- The current library for the job is used to locate the object.
- library-name
- Only the library named in this parameter is searched.
The possible change request description value is:
- change-request-description
- The name of the change request description object.
| Top |
Activity (ACTIVITY)
The name of the activity to change in the change request description.
- *LAST
- The activity will be the last to run in the change request.
- activity-ID
- A 10-character activity name.
| Top |
Action (ACTION)
Specifies the change management action to be performed by the added activity.
- *SAME
- The action value does not change.
- *ACP
- Relinquishes resources at a managed system required to maintain removability of a change. This cancels the removability of a change previously installed in a removable manner. The resources released are, typically, unaltered versions of components affected by the change.
- *ACT
- Causes the managed system to activate all previously installed changes. Each managed system implements the activation in its own way (for example, the activity will perform an initial program load (IPL) of a managed iSeries system or activate a configuration on a PS/2 and cause the PS/2 to restart).
- *DLT
- Requests a delete action at one or more managed systems.
- *INS
- Installs the objects previously packaged for installation on the specified managed system or systems. You can install up to seven objects. Only installable objects can be installed.
The objects are treated as corequisites, which means that either all installations succeed or all do not. The activity will use an object and its corequisites, if any, to alter all components necessary to effect the change. The managed system can perform such alteration in a removable manner if required, so that a subsequent request (Remove) can return all those components to their original condition prior to the alteration. Also automatic removal or automatic acceptance are possible.
- *RMV
- This activity, when run at the managed system, returns (that is, removes) all components previously altered in connection with a change to their condition prior to the installation of the change. This is possible only for changes previously installed in a removable manner.
- *RTV
- Retrieves an object identified by its global name, from a managed system or from another central site system, for storage at the central site system. To retrieve an object from more than one system, a global name with an *ANY token is required, so that each retrieved object has a unique global name. Global names with unspecified tokens (*ANY, *HIGHEST, or *LOWEST) are stored in the distribution repository when they are retrieved.
- *RUN
- Causes a program or procedure to be executed at one or more managed systems.
- *SND
- Sends an object from the central site system to one or more managed systems or to another central site system.
- *SNDINS
- Sends the objects previously packaged for installation at the central site system to one or more managed systems and installs the object at the managed system. Only objects identified by global names can be installed.
- *SNDRUN
- Sends an object from the central site system to one or more managed systems and runs the object at the managed system.
- *UNINS
- Removes the objects installed on the specified managed system or systems. Only objects installed through an installable object can be uninstalled.
| Top |
Global name (GLBNAME)
Specifies a global name, which is a series of tokens that uniquely identify an object in an SNA network. The global name represents the name that is used to locate the appropriate catalog entry on both the central site system and the managed systems. The catalog entry specifies the object that is used on that system.
Special values in a token position indicate how to search for the object. By specifying *ANY in a token position, the token is ignored when searching for the correct object.
The possible values are:
- *SAME
- The value does not change.
Element 1: Token 1
- *NETID
- The first global name token value is a network ID generated by the command from the network attributes. The network ID is determined by the current value of the LCLNETID network attribute value.
- global-name-token
- Specify the first token of the global name. The first token is recommended to be the registered enterprise ID or network ID.
Element 2-10: Token 2-10
- *ANY
- Any token value matches when searching for the object where the action is performed. This is useful when retrieving objects for which some of the tokens in the global name are not known or vary between systems.
- *HIGHEST
- The object with the highest token value has the action performed on it. The token must be ordered. This is useful when a token in a global name is used to indicate a different version of the object and you need to manipulate the object with the highest version level.
- *LOWEST
- The object with the lowest token value has the action performed on it. The token must be ordered. This is useful when a token in a global name is used to indicate a different version of the object and you need to manipulate the object with the lowest version level.
- *NETID
- The network ID of this system is used. The network ID is determined by the current value of the LCLNETID network attribute value.
- *CPNAME
- The control point name of this system is used. The control point is determined by the current value of the LCLCPNAME network attribute value.
- *SERVER:
- This token is stored within the change request activity with the value &SERVER, and is replaced by the short name of the change control server when the object is distributed.
- *TARGET:
- This token is stored within the change request activity with the value &TARGET, and is replaced by the short name of the target when the object is distributed.
- *MDDATE:
- This token is stored within the change request activity with the value &DATE, and is replaced when distributed by the date the object was last modified.
- *MDTIME:
- This token is stored within the change request activity with the value &TIME, and is replaced when distributed by the time the object was last modified.
- global-name-token
- Specify one of a series of 1 to 16 character tokens that uniquely identify the object on which the action is to be performed. Characters A through Z and 0 through 9 can be used. Other special values (@, #, and $) can be used for tokens that represent network IDs and system names.
Note: GLBNAME is valid only when ACTION(*ACT) or ACTION(*UNINS) is not specified.
| Top |
Component name (COMPNAME)
Component name, which is the set of global name tokens previous to the REF, FIX, or UPD subtree indicator (STI) tokens. The component name is used to identify the installable object that must be uninstalled from the managed system. The maximum number of tokens allowed is 7. COMPNAME is valid only when ACTION(*UNINS) is specified.
The only special value allowed for the first token is *NETID.
Element 1: Token 1
The possible values are:
- *SAME
- The value does not change.
- *NETID
- The network ID of this system is used. The network ID is determined by the current value of the LCLNETID network attribute value.
- component-name-token
- One of a series of 1 to 16 character tokens that uniquely identifies the object on which the action is to be performed. Characters A through Z and 0 through 9 can be used. Other special values (@, #, and $) can be used for tokens that represent network IDs and system names.
Elements 2-10: Tokens 2-10
- *NETID
- The network ID of this system is used. The network ID is determined by the current value of the LCLNETID network attribute value.
- *CPNAME
- The control point name of this system is used. The network ID is determined by the current value of the LCLCPNAME network attribute value.
- component-name-token
- One of a series of 1 to 16 character tokens that uniquely identifies the object on which the action is to be performed. Characters A through Z and 0 through 9 can be used. Other special values (@, #, and $) can be used for tokens that represent network IDs and system names.
| Top |
Managed systems node list (NODL)
Specifies that the node list parameter is the object name that contains a list of systems that are the destinations for the activity. This parameter cannot be specified if the control point name (CPNAME) parameter is also specified.
The possible values are:
- *SAME
- The value does not change.
- *NONE
- The systems on which this activity is to be performed are not specified by a node list. Individual control point names must be specified.
The possible library values are one of the following:
- *LIBL
- All of the libraries in the user and system portions of the job's library list are searched for the node list object.
- *CURLIB
- The current library for the job is used to locate the node list object.
- library-name
- Specify the name of the library to be searched.
- node-list-name
- Specify the node list object name containing the list of systems on which the activity is to be performed.
| Top |
Managed system node names (CPNAME)
Specifies the APPN control point names of the managed systems on which this activity is to be performed. Control point names cannot be specified if the node list (NODL) parameter is specified.
The possible values are:
- *SAME
- The value does not change.
- *NONE
- The systems on which this activity is performed are not identified individually. A node list must be specified.
- *NETATR
- The network ID of the local system is used. This is useful when the node being specified is in the same network as the local system.
- network-identifier
- Specify the APPN network identifier of the managed system on which the activity is to be performed. For NetView Distribution Management Agents, the network identifier is the change control server name.
- control-point-name
- Specify the APPN control point name of the managed system on which the activity is to be performed. For NetView Distribution Management Agents, the control point name is the change control client which supports numeric characters (0-9) in the first position of control point names that are valid in other platforms.
| Top |
Text 'description' (TEXT)
Specifies the activity description.
- *SAME
- The value does not change.
- *BLANK
- No text is specified.
- *GEN
- A description is generated based on the action selected. The descriptions generated are:
- Accept object
- Restart the system
- Delete object
- Run object
- Install object
- Remove object
- Retrieve object
- Send object
- Send and run object
- Send and install object
- Uninstall object
- text-description
- Specify a 50-character description of the activity.
| Top |
Activation force (ACTFRC)
Specifies whether or not the managed system should proceed with the activation based on its quiesced state.
- *SAME
- Activation force values do not change.
- activation force
- Specify the activation force value.
- *NO
- The managed system will not proceed with the activation if the quiesce check shows that the managed system is still active.
- delay units
- Specify the unit of time on which the delay period is specified.
- *SECONDS
- The delay period will be specified in seconds.
- *MINUTES
- The delay period will be specified in minutes.
- *HOURS
- The delay period will be specified in hours.
- delay period
- Specifies the maximum amount of time that the managed system may wait to quiesce (if not already quiesced) before taking the action specified:
- 3600
- The delay period default is 3600 seconds.
- delay-period
- Delay period range is 1-65535.
- *YES
- The managed system will proceed with the activation even if the quiesce check shows that the managed system is still active. Delay units and delay period are ignored when activation force is *YES.
Note: ACTFRC is valid only when ACTION(*ACT) is specified.
| Top |
Activation use on activate (ACTUSEACT)
Specifies which components altered by changes will be used during the activation.
- *SAME
- Activation use on activate value does not change.
- *BOTH
- Both, trial and production version.
- *PROD
- Production version only.
- *LAST
- Last used; either both trial and production or production only.
- *NONE
- No activation use on activate is specified.
Note: ACTUSEACT is valid only when ACTION(*ACT) is specified.
| Top |
Compression type (CPRTYPE)
Specifies the compression algorithm and related information associated with the compression of a particular change object. When either or both the transfer state or store state parameter specify compressed, this parameter must be present and one (and only one) of the adaptive compression, SNA compression, or user compression algorithms may be requested.
- *SAME
- Compression algorithm does not change.
- *ADAPTIVE
- Specify whether or not adaptive compression pertains to the requested object. iSeries does not support *ADAPTIVE.
- *SNA
- Specify whether or not SNA compression pertains to the requested object.
- *USER
- Specify whether or not a named user compression pertains to the requested object.
- *NONE
- No compression type is specified.
Notes:
- CPRTYPE is valid only when ACTION(*RTV), ACTION(*SND), ACTION(*SNDRUN) or ACTION(*SNDINS) is specified
- CPRTYPE cannot be specified when CMPSTGSTT and CPRTFRSTT are not specified.
- CPRTYPE cannot be specified when CMPSTGSTT is *DECOMPRESS and CPRTFRSTT is not specified.
- CPRTYPE cannot be specified when CPRSTGSTT is not specified and CPRTFRSTT is *DECOMPRESS.
- CPRTYPE cannot be specified when CPRSTGSTT and CPRTFRSTT are *DECOMPRESS.
| Top |
SNA compression character (SNACPRCHR)
Specifies information about the SNA compression algorithm as it pertains to the requested object. If omitted, the implication is that SNA compression does not pertain to the requested object.
- *SAME
- SNA compression does not change.
- *BLANK
- When SNA compression is requested, it is optionally specified with the implied default being the (X'40') character. Otherwise, it is not specified.
- SNA-prime-character
- The prime compression character to be associated with the single control byte (SCB) used by the SNA compression algorithm. Valid values are '00'X - 'FF'X
Note: SNACPRCHR is valid only when ACTION(*RTV), ACTION(*SND), ACTION(*SNDRUN). or ACTION(*SNDINS) is specified.
| Top |
User compression information (USRCPRINF)
Specifies information about a named user compression algorithm as it pertains to the requested object. If omitted, the implication is that user compression does not pertain to the requested object.
- *SAME
- User compression does not change.
- user-compression-name
- The name of the user compression algorithm that pertains to the requested object. It should be specified when user compression is requested. Otherwise, it is not specified.
- user-parameters
- User parameters that apply to the user compression algorithm named in the user compression name. It is optionally specified when user compression is requested. Otherwise it is not specified.
Note: USRCPRINF is valid only when ACTION(*RTV), ACTION(*SND), ACTION(*SNDRUN) or ACTION(*SNDINS) is specified.
| Top |
Compression storage state (CPRSTGSTT)
Specifies whether or not the object should be stored in compressed format at the managed system.
- *SAME
- Compression store state value does not change.
- *DECOMPRESS
- Store the object in decompressed format at the managed system. If already decompressed when it arrives at the managed system, store it as received. Otherwise, decompress the object using the compression method used to catalog the object in the managed system before storing it.
- *COMPRESS
- Store the object in compressed format at the managed system. When this value is specified, the compression algorithm must also be specified. If already compressed when it arrives at the managed system, store the object as received. Otherwise, compress the object using the compression algorithm before storing it.
- *NONE
- No compression storage state is specified.
Note: CPRSTGSTT is valid only when ACTION(*RTV), ACTION(*SND), ACTION(*SNDRUN) or ACTION(*SNDINS) is specified.
| Top |
Compression transfer state (CPRTFRSTT)
Specifies whether or not the object should be transferred to the managed system in compressed format.
- *SAME
- Compression transfer state value does not change.
- *DECOMPRESS
- Transfer the object in decompressed format at the managed system. If already decompressed at the source, transfer the object as stored. Otherwise, decompress the object using the compression method used to catalog the object in the managed system before transferring it.
- *COMPRESS
- Compress the object using the Compression Algorithm and transfer the object in compressed format to the managed system. When this value is specified the compression algorithm must also be specified. If already compressed using a different algorithm at the source, decompress the object using the compression method used to catalog the object in the managed system before transferring it.
- *NONE
- No compression transfer state is specified.
Note: CPRTFRSTT is valid only when ACTION(*RTV), ACTION(*SND), ACTION(*SNDRUN) or ACTION(*SNDINS) is specified.
| Top |
Activation use on install (ACTUSEINS)
Specifies whether the component to be altered by the installation process will be trial version or production version. If activation use on install is *TRIAL, it means the object should be installed in the trial area to be tested, then removability must be *YES.
- *SAME
- Activation use on activate value does not change.
- *TRIAL
- Trial version only.
- *PROD
- Production version only.
Note: ACTUSEINS is valid only when ACTION(*INS) or ACTION(*SNDINS) is specified.
| Top |
Alter active components (ALTACTCOMP)
Specifies whether or not the managed system is allowed to apply the component alterations to the active system; if not, then such action is to be deferred until the next activation. This parameter is only allowed for *SNDINS action.
- *SAME
- Alter active components value does not change.
- *ALLOWED
- Managed system is allowed to apply the component alterations to the active system.
- *NOTALLOWED
- Managed system is not allowed to apply the component alterations to the active system.
- *NONE
- No alter active component is specified.
Note: ALTACTCOMP is valid only when ACTION(*INS), ACTION(*SNDINS), or ACTION(*RMV) is specified.
| Top |
Auto accept (AUTOACP)
Specifies whether the managed system accepts objects automatically if installation and any test performed are successful, in order to release resources required to maintain removability as soon as possible. Like a separate Accept request, the managed system deletes the objects after successful automatic acceptance.
- *SAME
- Auto accept value does not change.
- *NO
- Do not perform automatic acceptance.
- *NONE
- No auto accept is specified.
- auto accept
- Auto acceptance possible values:
- *DESIRED
- Perform automatic acceptance if the specified managed system supports it.
- *YES
- Perform automatic acceptance.
- delay-days
- Specifies the number of days the entry point is expected to wait before accepting the object automatically. Valid range of days is 0-255.
Note: AUTOACP is valid only when ACTION(*INS) or ACTION(*SNDINS) is specified.
| Top |
Auto remove (AUTORMV)
Specifies whether or not the managed system removes the object automatically if either installation or a test fails.
- *SAME
- Auto remove value does not change.
- *DESIRED
- Perform automatic removal if the specified managed system supports it.
- *YES
- Perform automatic removal.
- *NO
- Do not perform automatic removal.
- *NONE
- No auto remove is specified.
Note: AUTORMV is valid only when ACTION(*INS) or ACTION(*SNDINS) is specified.
| Top |
Pre test (PRETEST)
Specifies whether or not the entry point is to perform a test on the objects prior to installing them.
- *SAME
- Pretest value does not change.
- *DESIRED
- Perform a pretest, if the specified managed system supports it.
- *YES
- Perform a pretest.
- *NO
- Do not perform a pretest.
Note: PRETEST is valid only when ACTION(*INS) or ACTION(*SNDINS) is specified.
| Top |
Post test (POSTTEST)
Specifies whether or not the entry point is to perform a test on the objects after installing or removing them.
- *SAME
- Posttest value does not change.
- *YES
- Perform a posttest.
- *DESIRED
- Perform a posttest if the specified managed system supports it.
- *NO
- Do not perform a posttest.
Note: POSTTEST is valid only when ACTION(*INS), ACTION(*SNDINS) or ACTION(*RMV) is specified.
| Top |
Allow remove (ALWRMV)
Specifies whether or not objects are to be installed in a removable manner (so that a subsequent Remove action can be issued against them).
- *SAME
- Removability value does not change.
- *YES
- Install the object in a removable manner.
- *DESIRED
- Install the object in a removable manner if the specified managed system supports it.
- *NO
- Do not install the object in a removable manner.
Note: ALWRMV is valid only when ACTION(*INS) or ACTION(*SNDINS) is specified.
| Top |
Initiate parameters (PARM)
Specifies the parameters to be passed when initiating an object.
- *SAME
- Parameter value does not change.
- parameter data
- Specifies the parameters to be passed when starting the program. Each parameter is a 1 to 253 character. The prompt panel will initially allow 25 characters to be entered. By entering an & in position 1, the field will be expanded for larger parameters. If the parameters include blanks or special characters enclose them in apostrophes.
Note: PARM is valid only when ACTION(*RUN) or ACTION(*SNDRUN) is specified.
| Top |
Keep object (KEEPOBJ)
Specifies whether or not the object should be kept or deleted after the function has been successfully performed.
- *SAME
- Object disposition value does not change.
- *YES
- The object should be kept after performing the function.
- *NO
- The object should be deleted after performing the function.
- *NONE
- No keep object is specified.
Note: KEEPOBJ is valid only when ACTION(*RUN), ACTION(*INS), ACTION(*SNDRUN) or ACTION(*SNDINS) is specified.
| Top |
Corequisite change name list (COREQCHGNL)
Specifies a list of SNA/file services (SNA/FS) global names identifying the names of objects that are to be installed by the entry point as a part of the installation of the object to be retrieved. A maximum of six corequisite change names are allowed.
The global name is a unique name you assign to the object so that it is not confused with any other object in a network. The global name represents the name that will be used to locate the appropriate catalog entry on both the central site system and managed systems.
- *SAME
- Corequisite change name list does not change.
- *NONE
- No corequisite change name list is specified.
- global-name-token
- One of a series of 1-16 character tokens that uniquely identify the object on which the action is to be performed. Characters A through Z and 0 through 9 may be used. Other special values (@, #, and $) may be used for tokens that represent network IDs and system names.
Note: COREQCHGNL is valid only when ACTION(*INS) or ACTION(*SNDINS) is specified.
| Top |
Replace object (REPLACE)
Specifies that the object should be replaced if it already exists.
- *SAME
- Replace value does not change.
- *NO
- The object must be added.
- *YES
- The object must be replaced.
- *ALLOWED
- The object should be replaced or added.
Note: REPLACE is valid only when ACTION(*RTV), ACTION(*SND), ACTION(*SNDRUN) or ACTION(*SNDINS) is specified.
| Top |
To be deleted name (TODLTNAME)
Specifies the name of the object, at the managed system location, that is to be deleted.
Special values in a token position indicate how to search for the object. By specifying *ANY in a token position, it means that the token is ignored when searching for the correct object. If multiple objects are found matching the tokens specified an error is returned.
The single values allowed are:
- *SAME
- The to be deleted name does not change.
- *NONE
- No to be deleted name is specified.
The special values allowed for the first token are *NETID, *SERVER, *TARGET, *MDDATE, and *MDTIME.
The special values allowed for the other tokens are:
- *ANY
- Any token value matches when searching for the object upon which the action is to be performed.
- *HIGHEST
- The object with the highest token value will have the action performed upon it. The token must be ordered. Useful when a token in a global name is used to indicate a different version of the object and you wish to manipulate the object with the highest version level.
- *LOWEST
- The object with the lowest token value will have the action performed upon it. The token must be ordered. Useful when a token in a global name is used to indicate a different version of the object and you wish to manipulate the object with the lowest version level.
- *NETID
- The network ID of this system is used. The network ID is determined by the current value of the LCLNETID network attribute value.
- *CPNAME
- The control point name of this system is used. The network ID is determined by the current value of the LCLCPNAME network attribute value.
- *SERVER:
- This token is stored within the change request activity with the value &SERVER, and is replaced by the short name of the change control server when the object is distributed.
- *TARGET:
- This token is stored within the change request activity with the value &TARGET, and is replaced by the short name of the target when the object is distributed.
- *MDDATE:
- This token is stored within the change request activity with the value &DATE, and is replaced when distributed by the date the object was last modified.
- *MDTIME:
- This token is stored within the change request activity with the value &TIME, and is replaced when distributed by the time the object was last modified.
- global-name-token
- One of a series of 1-16 character tokens that uniquely identify the object on which the action is to be performed. Characters A-Z and 0-9 may be used. Other special values (@, #, and $) may be used for tokens that represent network IDs and system names.
Notes:
- TODLTNAME is valid only when ACTION(*SND), ACTION(*SNDRUN) or ACTION(*SNDINS) is specified.
- The number of tokens specified in the TODLTNAME parameter must match the number of tokens specified in the GLBNAME parameter.
| Top |
Refresh level (REFLVL)
Specifies the level of the software component to be uninstalled.
- *SAME
- Refresh level value does not change.
- *NONE
- No refresh level list is specified.
- refresh-level
- Specify a numeric character string of up to 16 digits.
Note: REFLVL is valid only when ACTION(*UNINS) is specified.
| Top |
Force uninstall (FRCUNINS)
Specifies whether to perform the uninstallation even if the software component includes an object that is waiting to be installed or an object that is currently being installed.
- *SAME
- Force uninstallation value does not change.
- *NO
- Do not allow uninstallation if there are objects, for the software component, waiting to be installed.
- *YES
- Allow uninstallation even if there are objects, for the software component, waiting to be installed.
Note: FRCUNINS is valid only when ACTION(*UNINS) is specified.
| Top |
Start time on managed system (RMTSTRTIME)
Specifies the date and time when the activity can begin running on the managed system. The current date and time values and the next date values are determined when the activity begins running at the central site systems based on the central site date and time.
The possible single value is:
- *NONE
- There is no remote start time specified for the managed system.
Element 1: Time Zone
The time zone of the remote start time.
The possible values are:
- *SAME
- The value does not change.
- *LCLSYS
- The remote start time is specified in the time zone of the central site system.
- *MGDSYS
- The remote start time is specified in the time zone of the managed system.
Element 2: Start After Time
This is the definition of the time after which the activity is to start.
- *SAME
- The value does not change.
- *CURRENT
- This function can start on the managed system at any time on or after the time this activity is started on the central site system on the date specified in element 2.
- start-after-time
- Specify the time when this function can start on the managed system. The time can be entered as 4 or 6 digits (hhmm or hhmmss) where hh = hours, mm = minutes, and ss = seconds. Seconds are optional. The time can be specified with or without a time separator. With a time separator, specify a string of 5 or 8 digits (hh:mm or hh:mm:ss).
Element 3: Start After Date
This is the start after date.
- *SAME
- The value does not change.
- *CURRENT
- This function starts on the managed system on any date on or after the activity starts on the central site system.
- *NEXT
- This function starts on the managed system on any date after the activity starts on the central site system.
- start-after-date
- Specify the date after the functions start on the managed system. The date must be specified in the job date format.
Notes:
- The special values *CURRENT and *NEXT cannot be specified for the date and the time when the time zone value *MGDSYS is specified.
- This parameter is valid when these actions are specified: *ACP, *ACT, *RUN, *INS, *RMV, *SNDRUN, *SNDINS, or *UNINS.
| Top |
Activity conditions (COND)
Specifies which conditions must be met before this activity can be performed. Each condition identifies an activity that must run before this activity and the value the end code from that activity must have to allow this activity to run. The default condition is that the previous activity (in alphabetical order) must complete successfully before this activity can be run.
The possible single values are:
- *SAME
- The value does not change.
- *NONE
- There are no conditions for this activity.
Element 1: Conditioning Activity
The activity that must be run before this activity.
- *PRV
- This activity is conditioned on the previous activity. Activities are ordered alphabetically by activity name. If the activity being added is the first activity, a previous activity does not exist and any condition with *PRV is marked as having been met.
- conditioning-activity-name
- Specify the name of the activity that must be run before this activity. The activity name specified in the activity (ACTIVITY) parameter cannot be specified in the conditioning activity name. An activity cannot be conditioned on itself.
- generic*-conditioning-activity-name
- Specify the generic name of the activities that must run before this activity.
Element 2: Relational Operator
This element is the relational operator to use when comparing the end code from an activity.
- *EQ Equal
- *GT Greater than
- *LT Less than
- *NE Not equal
- *GE Greater than or equal
- *LE Less than or equal
Element 3: Condition Code
The element is the value compared to the actual end code of the conditioning activity.
- *SUCCESS
- The activity ended successfully (0 <= end code <= 9). This end code can only be specified with relational operator *EQ or *NE.
- *FAIL
- The activity failed (10 <= end code <= 89). This end code can only be specified with relational operator *EQ or *NE.
- *NOTRUN
- The activity never started (90 <= end code <= 99). This end code is only specified with relational operator *EQ or *NE.
- *ANY
- The activity ended with any end code. This end code is only specified with relational operator *EQ.
- end-code
- Specify an integer value (0-99) that indicates the result of an activity (success or failure). The end code ranges and descriptions are:
- 00
- Activity completed successfully.
- 01-09
- Activity completed with warning messages.
- 10-29
- Activity did not complete successfully.
- 30-39
- Activity was canceled by a user before it completed.
- 30 = Activity ended with *CNTRLD option
- 35 = Activity ended with *IMMED option
- 39 = Activity ended with *FRCFAIL option
- 40-49
- Activity was not run due to errors detected by the application.
- 40 = Activity not run for security reasons
- 90-99
- Activity was not run because conditions or schedules were not met.
- 95 = Scheduled start time expired
- 99 = Conditions cannot be met
Element 4: Condition Mode
This element indicates which systems the conditioning activity must have completed on before this activity can be performed.
- *ALLNODES
- The conditioning activity specified must complete on all nodes before this activity runs.
- *SAMENODE
- When the conditioning activity specified completes for a given node, the activity specified on the ACTIVITY parameter can run for that same node even though the conditioning activity specified cannot have completed for all other nodes. In the case where this activity can run for that node, the condition is ignored.
| Top |
Activity start time (STRTIME)
Specifies the date and the time when this activity can be started on the central site system. The current date and time values and the next date values are determined when the change request is submitted.
Element 1: Start After Time
The possible values are:
- *SAME
- The value does not change.
- *CURRENT
- This activity can start on or after the time when the change request is submitted.
- start-after-time
- Specify the time when this activity can start. The time can be entered as 4 or 6 digits (hhmm or hhmmss) where hh = hours, mm = minutes, and ss = seconds. Seconds are optional. The time can be specified with or without a time separator such as a colon (:). With a time separator, specify a string of 5 or 8 digits (hh:mm or hh:mm:ss).
Element 2: Start After Date
- *SAME
- The value does not change.
- *CURRENT
- This activity can start on or after the date on which the change request is submitted.
- *NEXT
- The activity can start on any date after the date the change request is submitted.
- start-after-date
- Specify the date after this activity can start. The date must be specified in the job date format.
Element 3: Start Before Time
This element is ignored if the start before date is *ANY.
- *SAME
- The value does not change.
- *ANY
- The activity can start at any time on or before the start before date.
- *CURRENT
- The activity must start before the time at which the change request was submitted on the date specified on the start before data element. This value cannot be specified if the start before date is *CURRENT.
- start-before-time
- Specify the time before which the activity must start. If the activity cannot be started before this time, it never starts. The time can be entered as 4 or 6 digits (hhmm or hhmmss) where hh = hours, mm = minutes, and ss = seconds. Seconds are optional. The time can be specified with or without a time separator such as a colon (:). With a time separator, specify a string of 5 or 8 digits (hh:mm or hh:mm:ss).
Element 4: Start Before Date
- *SAME
- The value does not change.
- *ANY
- The activity can start at any time after the start after time and the start after date.
- *CURRENT
- The activity must start on the date the change request is submitted.
- *NEXT
- The activity must start by the day after the date the change request is submitted.
- start-before-date
- Specify the date before the activity must start. If the activity cannot be started by this date, it never starts. The date must be specified in the job date format.
| Top |
Hold activity (HOLD)
Hold the activity when the change request is submitted.
- *SAME
- The value does not change.
- *NO
- The activity is not held and will run when all conditions are met.
- *YES
- The activity is held for all nodes when the change request is submitted. It must be released by you before it runs.
| Top |
Examples
The following examples illustrate how to use the CHGCRQA 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 by their activity actions:
- Accept
- Activate
- Delete
- Run
- Install
- Remove
- Retrieve
- Send, Send and Run, and Send and Install
- Uninstall
Example 1: Accept Actions
The examples shown here match the first two examples 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(*PROD) ALTACTCOMP(*NOTALLOWED) AUTOACP((*YES)) ALWRMV(*YES) COREQCHGNL((REXX PROC UPDATE CONFIG))Instead of installing the objects on the single system MARYPWS1, the objects should be installed on all the managed systems controlled by the change control server ROMSERV1. (All the managed systems are listed in the node list ROMCLIENTS stored in library ROMLIB.)
The activity is changed in the following example so the objects can be installed in a removable manner, if removability is supported on the managed systems.
CHGCRQA CRQD(CCLIB/CRQACPRMV) ACTIVITY(INSACT01) ACTION(*SAME) GLBNAME(*SAME) NODL(ROMLIB/ROMCLIENTS) CPNAME(*NONE) ACTUSEINS(*SAME) ALTACTCOMP(*SAME) AUTOACP((*NO)) ALWRMV(*DESIRED) COREQCHGNL(*SAME)The objects IBM 1234567 PMGRAB UPD 1 2 and REXX PROC UPDATE CONFIG are installed in a removable manner. The objects can be accepted by changing the accept activities. The activities were added to the change request as follows:
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))But the activities need to be changed to:
CHGCRQA CRQD(CCLIB/CRQACPRMV) ACTIVITY(ACCACT01) ACTION(*SAME) GLBNAME(*SAME) NODL(ROMLIB/ROMCLIENTS) CPNAME(*NONE) COND((INSACT03 *EQ *SUCCESS *ALLNODES)) CHGCRQA CRQD(CCLIB/CRQACPRMV) ACTIVITY(ACCACT02) ACTION(*SAME) GLBNAME(*SAME) NODL(ROMLIB/ROMCLIENTS) CPNAME(*NONE) COND((INSACT03 *EQ *SUCCESS *ALLNODES)) - The install activity added to the change request description is:
ADDCRQA CRQD(CCLIB/CRQACPRMV) ACTIVITY(INSACT02) ACTION(*INS) GLBNAME(EURO WORDPROD UPD 2 3 US) CPNAME((EUROITAL FREDSWS)) ALWRMV(*YES)Instead of installing the objects on the single system MARYPWS1. the objects should be installed on all the managed systems controlled by the change control server EUROITAL. (All the managed systems are listed in the node list EUROCLIENT stored in library EUROLIB.) To install the objects on all managed systems, the activity is changed to:
CHGCRQA CRQD(CCLIB/CRQACPRMV) ACTIVITY(INSACT02) ACTION(*SAME) GLBNAME(*SAME) NODL(EUROLIB/EUROCLIENT) CPNAME(*NONE) ALWRMV(*YES)To accept the object EURO WORDPROD UPD 2 3 US on all the managed systems, the activity ACCACT01 is added to the change request CRQACPRMV:
ADDCRQA CRQD(CCLIB/CRQACPRMV) ACTIVITY(ACCACT01) ACTION(*ACP) GLBNAME(EURO WORDPROD UPD 2 3 US) CPNAME((EUROITAL FREDSWS)) COND((INSACT05 *EQ *SUCCESS *SAMENODE))Should be changed as follows:
CHGCRQA CRQD(CCLIB/CRQACPRMV) ACTIVITY(ACCACT01) ACTION(*SAME) GLBNAME(*SAME) NODL(EUROLIB/EUROCLIENT) CPNAME(*NONE) COND((INSACT05 *EQ *SUCCESS *ALLNODES))
Example 2: Activate Actions
- Change an activate activity to use trial a production version during the activation.
CHGCRQA CRQD(CCLIB/CRQINSACT) ACTIVITY(ACTACT01) ACTION(*ACT) CPNAME((ROMSERV1 MARYPWS1)) ACTFRC(*NO *HOURS 6) ACTUSEACT(*BOTH) 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 will wait up to six hours before proceeding with the activation if the system is still active.
- Change 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 will occur as soon as possible after 11 p.m. on 15 April 2006 in the time zone where FREDSWS is located. The activation will occur even if the managed system FREDSWS is still active.
The delay units and delay period are ignored because activation force is *YES.
CHGCRQA CRQD(CCLIB/CRQINSACT) ACTIVITY(ACTACT02) ACTION(*ACT) CPNAME((EUROITAL FREDSWS)) ACTFRC((*YES *MINUTES 30)) RMTSTRTIME(*MGDSYS (23:00:00 04/15/06))
Example 3: Delete Actions
- Change 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.
CHGCRQA CRQD(CCLIB/CRQDLT) ACTIVITY(DLTACT01) ACTION(*DLT) GLBNAME(EURO WORDPROD UPD 2 3 US) CPNAME((EUROITAL FREDSWS)) - Change an activity to delete all test files from systems MARYPWS1, MARYPWS2, MARYPWS3, and MARYPWS4. All these systems are controlled by the change control server ROMSERV1. The test files on those systems are cataloged as EURO SPELLCHECK TEST file-name.
CHGCRQA CRQD(CCLIB/CRQSNDDLT) ACTIVITY(DLTACT02) ACTION(*ACT) GLBNAME(EURO SPELLCHECK TEST *ANY) CPNAME((ROMSERV1 MARYPWS1) (ROMSERV1 MARYPWS2) (ROMSERV1 MARYPWS3) (ROMSERV1 MARYPWS4)) COND((SNDACT01 *EQ *SUCCESS *ALLNODES))This activity occurs 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 5: Run Actions
- Change 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 program is run as soon as possible.
CHGCRQA CRQD(CCLIB/CRQRUN) ACTIVITY(RUNACT01) ACTION(*RUN) GLBNAME(EURO VIRUSCHK EXE 1 US) CPNAME((EUROITAL FREDSWS)) PARM(("/usr/bin")) - Change 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.
CHGCRQA CRQD(CCLIB/CRQRUN) ACTIVITY(RUNACT02) ACTION(*RUN) GLBNAME(EURO WORDPROC EXE 2 US) CPNAME((*NETATR JOHNSWS)) KEEPOBJ(*KEEP)
Example 6: Install Actions
The first two examples shown here match those shown for the accept and remove examples.
- The install activity is:
ADDCRQA CRQD(CCLIB/CRQACPRMV) ACTIVITY(INSACT01) 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))Instead of installing the objects on the single system MARYPWS1, the objects should be installed on all the managed systems controlled by the change control server ROMSERV1. (All the managed systems are listed in the node list ROMCLIENTS stored in library ROMLIB.) To install the objects in a removable manner, the install activity is changed to:
CHGCRQA CRQD(CCLIB/CRQACPRMV) ACTIVITY(INSACT01) ACTION(*SAME) GLBNAME(*SAME) NODL(ROMLIB/ROMCLIENTS) CPNAME(*NONE) ACTUSEINS(*SAME) ALTACTCOMP(*SAME) AUTOACP((*NO)) ALWRMV(*DESIRED) COREQCHGNL(*SAME) - The install activity is:
ADDCRQA CRQD(CCLIB/CRQACPRMV) ACTIVITY(INSACT02) ACTION(*INS) GLBNAME(EURO WORDPROD UPD 2 3 US) CPNAME((EUROITAL FREDSWS)) ALWRMV(*YES)Instead of install the objects on the single system MARYPWS1, the objects should be installed on all the managed systems controlled by the change control server EUROITAL. (All the managed systems are listed in the node list EUROCLIENT stored in library EUROLIB.) To install the objects on all the managed systems, the install activity is changed to:
CHGCRQA CRQD(CCLIB/CRQACPRMV) ACTIVITY(INSACT02) ACTION(*SAME) GLBNAME(*SAME) NODL(EUROLIB/EUROCLIENT) CPNAME(*NONE) ALWRMV(*YES) - Change 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.
CHGCRQA CRQD(CCLIB/CRQINS) ACTIVITY(INSACT03) ACTION(*INS) GLBNAME(IBM 1234567 PMGRAB UPD 1 2) CPNAME((ROMSERV1 MARYPWS1)) ACTUSEINS(*TRIAL) ALWRMV(*YES) - Change 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 2006.
CHGCRQA CRQD(CCLIB/CRQINS) ACTIVITY(INSACT04) 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/06)) - Change 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 objects are installed to the active area in a removable manner. The installation is not automatically accepted. The installation is scheduled for 3 p.m. on 1 January 2006.
CHGCRQA 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/06)) COND((RTVACT01 *EQ *SUCCESS *ALLNODES))The activity can be performed only if the object EURO WORDPROC UPD 2 3 US is successfully retrieved from the change control client BRIGSWS.
ADDCRQA CRQD(CCLIB/CRQRTVINS) ACTIVITY(RTVACT01) ACTION(*RTV) GLBNAME(EURO WORDPROC UPD 2 3 US) CPNAME((EUROITAL BRIGSWS)) STRTIME((22:00:00 12/31/06) (06:00:00 1/01/07)) - Change 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 installation fails, the object is removed automatically.
CHGCRQA CRQD(CCLIB/CRQINS) ACTIVITY(INSACT06) ACTION(*INS) GLBNAME(IBM 1234567 WINDMB UPD 1 2) CPNAME((ROMSERV1 MARYPWS1)) ACTUSEINS(*PROD) AUTORMV(*YES) ALWRMV(*YES)
Example 7: Remove Actions
The examples shown here match the first two examples shown for the install examples and demonstrate how some of the installed objects can be removed.
- 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(*PROD) ALTACTCOMP(*NOTALLOWED) AUTOACP((*YES)) ALWRMV(*YES) COREQCHGNL((REXX PROC UPDATE CONFIG))Instead of installing the objects on the single system MARYPWS1, the objects should be installed on all the managed systems controlled by the change control server ROMSERV1. (All the managed systems are listed in the node list ROMCLIENTS stored in library ROMLIB.) The objects should be installed in a removable manner, if all managed systems support removability. To install the objects in a removable manner, the install activity is changed to:
CHGCRQA CRQD(CCLIB/CRQACPRMV) ACTIVITY(INSACT01) ACTION(*SAME) GLBNAME(*SAME) NODL(ROMLIB/ROMCLIENTS) CPNAME(*NONE) ACTUSEINS(*SAME) ALTACTCOMP(*SAME) AUTOACP((*NO)) ALWRMV(*DESIRED) COREQCHGNL(*SAME)The objects IBM 1234567 PMGRAB UPD 1 2 and REXX PROC UPDATE CONFIG are all installed in a removable manner. You can remove the objects by changing the accept activities to the following:
The activities were added to the change request as follows:
ADDCRQA CRQD(CCLIB/CRQINSACC) ACTIVITY(RMVACT01) ACTION(*RMV) GLBNAME(IBM 1234567 PMGRAB UPD 1 2) CPNAME((ROMSERV1 MARYPWS1)) COND((INSACT01 *EQ 20 *SAMENODE)) ADDCRQA CRQD(CCLIB/CRQINSACC) ACTIVITY(RMVACT02) ACTION(*RMV) GLBNAME(REXX PROC UPDATE CONFIG) CPNAME((ROMSERV1 MARYPWS1)) COND((INSACT01 *EQ 20 *SAMENODE))But they need to be changed to:
CHGCRQA CRQD(CCLIB/CRQINSACC) ACTIVITY(RMVACT01) ACTION(*SAME) GLBNAME(*SAME) NODL(ROMLIB/ROMCLIENTS) CPNAME(*NONE) COND((INSACT01 *EQ *SUCCESS *ALLNODES)) CHGCRQA CRQD(CCLIB/CRQINSACC) ACTIVITY(RMVACT02) ACTION(*SAME) GLBNAME(*SAME) NODL(ROMLIB/ROMCLIENTS) CPNAME(*NONE) COND((INSACT01 *EQ *SUCCESS *ALLNODES)) - The install activity added to the change request description is:
ADDCRQA CRQD(CCLIB/CRQACPRMV) ACTIVITY(INSACT02) ACTION(*INS) GLBNAME(EURO WORDPROD UPD 2 3 US) CPNAME((EUROITAL FREDSWS)) ALWRMV(*YES)Instead of installing the objects on the single system MARYPWS1, the objects should be installed on all the managed systems controlled by the change control server EUROITAL. (All the managed systems are listed in the node list EUROCLIENT stored in library EUROLIB.) The activity is changed to:
CHGCRQA CRQD(CCLIB/CRQACPRMV) ACTIVITY(INSACT02) ACTION(*SAME) GLBNAME(*SAME) NODL(EUROLIB/EUROCLIENT) CPNAME(*NONE) ALWRMV(*YES)To remove the object EURO WORDPROD UPD 2 3 US on all the managed systems, the activity RMVACT01 is added to change request CRQACPRMV:
ADDCRQA CRQD(CCLIB/CRQACPRMV) ACTIVITY(RMVACT01) ACTION(*RMV) GLBNAME(EURO WORDPROD UPD 2 3 US) CPNAME((EUROITAL FREDSWS)) COND((INSACT04 *EQ *SUCCESS *SAMENODE))should be changed as follows:
CHGCRQA CRQD(CCLIB/CRQACPRMV) ACTIVITY(RMVACT01) ACTION(*SAME) GLBNAME(*SAME) NODL(EUROLIB/EUROCLIENT) CPNAME(*NONE) COND((INSACT04 *EQ *SUCCESS *ALLNODES)) - Change an activity to schedule the removal of the previously installed object EURO.WORDPROD.REF.2.US from managed system FREDSWS with immediate effect but requiring activation.
CHGCRQA CRQD(CCLIB/CR6) ACTIVITY(ACT01) ACTION(*RMV) GLBNAME(EURO WORDPROD REF 2 US) CPNAME((EUROITAL FREDSWS)) ALTACTCOMP(*NOTALLOWED)
Example 8: Retrieve Actions
- Change an activity that causes the file EURO WORDPROC UPD 2 3 US to be retrieved from the managed system JOHNSWS. The file is transferred in a compressed format and then stored in a decompressed format. The SNA compression algorithm is used.
CHGCRQA CRQD(CCLIB/CRQRTV) ACTIVITY(RTVACT01) ACTION(*RTV) GLBNAME(EURO WORDPROC UPD 2 3 US) CPNAME((EUROITAL JOHNSWS)) CPRTYPE(*SNA) CPRSTGSTT(*DECOMPRESS) CPRTFRSTT(*COMPRESS) REPLACE(*ALLOWED) - Change an activity that causes the object EURO PCSOFT UPD 2 3 US to be retrieved from the managed system JOHNSWS. The file is to be transferred and stored in a compressed format. The user algorithm NVDMLZW is used. This user algorithm is supported if the object is not decompressed at the central site system.
CHGCRQA CRQD(CCLIB/CRQRTV) ACTIVITY(RTVACT02) ACTION(*RTV) GLBNAME(EURO PCSOFT UPD 2 3 US) CPNAME((EUROITAL JOHNSWS)) CPRTYPE(*USER) CPRSTGSTT(*COMPRESS) CPRTFRSTT(*COMPRESS) USRCPRINF(NVDMLZW 37 '/D') REPLACE(*ALLOWED) - Change an activity to retrieve the most recent nightly sales file from each system. The files are cataloged as EURO SALES system-name date-created. The file is sent and stored in a compressed format. The SNA compression algorithm is used. The file must be retrieved after 10 p.m. on the day the request is submitted but before 6 a.m. the next morning when the stores open. All files retrieved must be added to the distribution repository when they are retrieved.
CHGCRQA CRQD(CCLIB/CRQRTV) ACTIVITY(RTVACT03) ACTION(*RTV) GLBNAME(EURO SALES *ANY *HIGHEST) NODL(STORES) CPRTYPE(*SNA) CPRSTGSTT(*COMPRESS) CPRTFRSTT(*COMPRESS) REPLACE(*NO) STRTIME((22:00:00 *CURRENT) (06:00:00 *NEXT))
Example 9: Send, Send and Run, and Send and Install Actions
- Change an activity to send the file EURO SPELLCHECK EXE 1 US to the managed system FREDSWS. FREDSWS is controlled by the change control server EUROITAL. The file is not compressed. The file should be replaced or added at the managed system.
CHGCRQA CRQD(CCLIB/CRQSND) ACTIVITY(SNDCT01) ACTION(*SND) GLBNAME(EURO SPELLCHECK EXE 1 US) CPNAME((EUROITAL FREDSWS)) REPLACE(*ALLOWED) - Change an activity to send and install the two objects EURO WORDPROC REF 2 US and EURO WORDPROC UPD 2 3 US on managed system FREDSWS with the attributes that follow. The installation is done to the active area in a removable manner. The installation is not automatically accepted. It is scheduled for 3 a.m. on 13 April 2006 in the time zone where the managed system is located.
CHGCRQA CRQD(CCLIB/CRQSND) ACTIVITY(SNDCT02) ACTION(*SNDINS) GLBNAME(EURO WORDPROC REF 2 US) CPNAME((EUROITAL FREDSWS)) ALTACTCOMP(*ALLOWED) COREQCHGNL((EURO WORDPROC UPD 2 3 US)) RMTSTRTIME(*MGDSYS (15:00:00 04/13/06)) - Change an activity to send and run the program known by the global name EURO.VIRUSCHK.EXE.1.US on managed system FREDSWS. Pass the parameter /usr/bin to the program. The program is run as soon as possible.
CHGCRQA CRQD(CCLIB/CRQSND) ACTIVITY(SNDCT03) ACTION(*SNDRUN) GLBNAME(EURO VIRUSCHK EXE 1 US) CPNAME((EUROITAL FREDSWS)) PARM(("/usr/bin")) - Change activities to retrieve the program identified by the global name CUSTNET PCSOFT WDWAPP VER3 941128 from the PS/2 DEVPS2 controlled by the central site CUSTNET. Send and run the activity on all of the PS/2s in the southeast area. The activity is run at 11 p.m. in the time zone where the PS/2 is located only if the retrieve from the PS/2 DEVPS2 is successful. The activity names are generated.
CHGCRQA CRQD(CCLIB/CRQRTVSND) ACTIVITY(*GEN) ACTION(*RTV) GLBNAME(CUSTNET PCSOFT WDWAPP VER5 061230) CPNAME((CUSTNET DEVPS2))CHGCRQA CRQD(CCLIB/CRQRTVSND) ACTIVITY(*GEN) ACTION(*SNDRUN) GLBNAME(CUSTNET PCSOFT WDWAPP VER5 061230) NODL(PS2SE) RMTSTRTIME(*MGDSYS (23:00:00 12/30/06)) COND((*PRV *EQ *SUCCES *SAMENODE))
Example 10: Uninstall Actions
- Change an activity to uninstall the component EURO WORDPROC from managed system FREDSWS at the time and date specified. The system must be in a state of inactivity at that time. Do not perform the uninstall action if there are objects waiting to be installed.
CHGCRQA CRQD(CCLIB/CRQUNINS) ACTIVITY(UNSACT01) ACTION(*UNINS) COMPNAME(EURO WORDPROD) CPNAME((EUROITAL FREDSWS)) ALTACTCOMP(*NOTALLOWED) FRCUNINS(*NO) REFLVL("2") RMTSTRTIME(*MGDSYS (14:00:00 05/20/06))
| Top |
Error messages
None
| Top |