Add Resource CRQ Activity (ADDRSCCRQA)

Where allowed to run: All environments (*ALL)
Threadsafe: No

The Add Resource Change Request Activity (ADDRSCCRQA) command adds an activity to a change request description which performs an IPL of a managed iSeries system or restarts a non-iSeries resource such as a PS/2 with NetView DM/2 installed.

Restrictions:

You must have *CHANGE authority to the change request description and *EXECUTE to the library.
A resource other than *SYSx is not supported for iSeries managed systems.
If a value for NODL is specified, the node list can only contain entries that have a value of *SNA for the address type.
Keylock must be in NORMAL position or the request is rejected.

Notes:

The following notes provide information on how the command works.

Authorization to the product specified on the activity is not verified until the activity runs.
All conditions must be satisfied before the activity can run.
The start times indicate when the activity can be started. Actual start times can be later due to network and system delays.

Top

Parameters

Keyword	Description	Choices	Notes
CRQD	Change request description	Qualified object name	Required, Positional 1
	Qualifier 1: Change request description	Name
	Qualifier 2: Library	Name, LIBL, CURLIB
ACTIVITY	Activity	Name, GEN, LAST	Optional, Positional 2
ACTION	Action	*RESTART	Optional, Positional 3
RSC	Resource	Name, SYS, SYSA, *SYSB	Optional
NODL	Managed systems node list	Element list	Optional
	Element 1: Node list	Single values: *NONE Other values: Qualified object name
	Qualifier 1: Node list	Name
	Qualifier 2: Library	Name, LIBL, CURLIB
CPNAME	Managed system node names	Single values: *NONE Other values (up to 50 repetitions): Element list	Optional
	Element 1: Network identifier	Communications name, *NETATR
	Element 2: Control point	Character value
OPTION	How to end	CNTRLD, IMMED	Optional
DELAY	Delay time, if *CNTRLD	0-65535, 3600	Optional
TEXT	Text 'description'	Character value, *GEN	Optional
COND	Activity conditions	Single values: *NONE 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
	Element 2: Date	Date, CURRENT, NEXT
	Element 2: Start before	Element list
	Element 1: Time	Time, ANY, CURRENT
	Element 2: Date	Date, ANY, CURRENT, *NEXT
RMTSTRTIME	Start time on managed system	Element list	Optional
	Element 1: Time zone	LCLSYS, MGDSYS
	Element 2: Start after	Element list
	Element 1: Time	Time, *CURRENT
	Element 2: Date	Date, CURRENT, NEXT
HOLD	Hold activity	NO, YES	Optional

Top

Change request description (CRQD)

Specifies the change request description object name.

The possible library values are:

*LIBL: All of the libraries in the user and in the 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: Specify the name of the library to be searched.

The possible change request description value is:

change-request-description: Specify the name of the change request description object.

Top

Activity (ACTIVITY)

Specifies the name of the activity to add to the change request description.

*GEN: An activity name is generated. The activity name is of the form QACTxxxxxx, where xxxxxx is the first multiple of ten not already being used.
*LAST: The activity is the last to run in the change request. When *LAST is specified for the activity (ACTIVITY) parameter, the condition (COND) parameter and the start time (STRTIME) parameter cannot be specified. Only one activity named *LAST can exist in the change request description.
activity-name: Specify a 10-character activity name.

Top

Action (ACTION)

Specifies the functions to be performed on the resource.

*RESTART: Use to restart the specified resource. If the resource specified is *SYS, *SYSA, or *SYSB, the managed system stops and restarts.

Top

Resource (RSC)

Specifies the resource name.

*SYS: The action is performed against the entire system. For the restart action, this means that the managed system is powered down and restarted. The system panel determines the IPL source.
*SYSA: This is the same as *SYS except the IPL source is the A side.
*SYSB: This is the same as *SYS except the IPL source is the B side.
resource-name: Specify a 16-character resource name on the managed system. This value is not supported by iSeries managed systems.

Top

Managed systems node list (NODL)

Specifies that the node list parameter is the object name that contains a list of systems which are the destinations for the activity. This parameter cannot be specified if the control point name (CPNAME) parameter is also specified.

The possible value is:

*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:

*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.

The possible node list name value is:

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 performed. Control point names cannot be specified if a node list is specified.

*NONE: The systems on which this activity is performed are not identified individually. A node list must be specified.

The possible values are:

*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 performed.

The possible control point name value is:

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

How to end (OPTION)

Specifies how to end. It specifies whether the system allows the active subsystems to end processing of active jobs in a controlled manner, or whether the system ends the job immediately.

*CNTRLD: The jobs are ended in a controlled manner. If the jobs cannot be ended in a controlled manner during the delay period, they are ended immediately.
*IMMED: Jobs are ended immediately.

Top

Delay time, if *CNTRLD (DELAY)

Specifies the number of seconds the system waits for the jobs to be ended in a controlled manner.

3600: The system waits one hour before ending the jobs immediately.
delay-time: Specify the delay time in seconds.

Top

Text 'description' (TEXT)

Specifies the activity description.

*GEN: A description is generated.
text-description: Specify a 50 character description of the activity.

Top

Activity conditions (COND)

Specifies which conditions must be met before this activity can be performed. Each condition identifies an activity which must be 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 value is:

*NONE: There are no conditions for this activity.

The possible conditioning activity values are:

The activity which 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 which 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*-activity-name: Specify the generic name of the activities which must run before this activity.

The possible relational operator values are:

This element is the relational operator to use when comparing the end code from the conditioning activity.

*EQ: Equal
*GT: Greater than
*LT: Less than
*NE: Not equal
*GE: Greater than or equal
*LE: Less than or equal

The possible condition code values are:

*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 is 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 the 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

The possible condition mode values are:

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 may run for that same node even though the conditioning activity specified may not have completed for all other nodes. In the case where this activity lists a node not in the conditioning activity, this activity may run for that node; the condition is ignored.

Top

Activity start time (STRTIME)

Specifies the date and time when this activity can be started on the central site system. The current date and time values and next date values are determined when the change request is submitted.

The possible start after time values are:

*CURRENT: This activity can start any time 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).

The possible start after date values are:

*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 when 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.

The possible start before time values are:

This element is ignored if the start before date is *ANY.

*ANY: The activity can start at any time on or before the start before date.
*CURRENT: The activity must start before the time when 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 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).

The possible start before date values are:

*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

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 next date values are determined when the activity begins running on the central site system based on the central site date and time.

The possible time zone values are:

*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.

The possible start after time values are:

This is the definition of the time when the activity is to start.

*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 3.
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).

The possible start after date values are:

*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 are specified for the date and the time if the time zone value *MGDSYS is specified.
This parameter can only be specified if *RUN or *SNDRUN actions are specified.

Top

Hold activity (HOLD)

Specifies that the activity be held when the change request is submitted.

*NO: The activity is not held and it runs when all conditions and the start time are met.
*YES: The activity is held for all nodes when the change request is submitted. It must be released by a user before it will run.

Top

Examples

Example 1: Adding an Activity

ADDRSCCRQA   CRQD(MYLIB/CR1)  ACTIVITY(ACT01)
             ACTION(*RESTART)  RSC(*SYS)
             STRTIME((04:00:00 *NEXT))
             NODL(NETLIB/STORES)

This command adds an activity to re-IPL the store systems at 4:00 a.m. tomorrow. These store systems are identified in the STORES node list.

Example 2: Performing an IPL

ADDRSCCRQA   CRQD(MYLIB/CR1)  ACTIVITY(ACT01)
             ACTION(*RESTART)  RSC(*SYSA)
             CPNAME((*NETATR SYS1))  OPTION(*IMMED)

This command adds an activity to perform an IPL of the system SYS1 immediately to the A side.

Top

Error messages

None

Top