Change CRQ Description (CHGCRQD)

Where allowed to run: All environments (*ALL)
Threadsafe: No
Parameters
Examples
Error messages

The Change Change Request Description (CHGCRQD) command is used to change a change request description. A change request description contains a list of activities that are performed to complete the specified change. A prompt override is called to provide the current values.

Restrictions:

  1. You must have *CHANGE authority to the change request description object.
  2. To change the user profile, you must be the owner of the object or must have *ALLOBJ and *SECADM authority.
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
USRPRF User profile *SAME, *SBM, *OWNER Optional
PRBID Problem identifier Character value, *SAME, *NONE Optional
PRBORG Problem origin Single values: *SAME
Other values: Element list
Optional
Element 1: Network identifier Communications name, *NETATR
Element 2: Control point name Communications name, *NETATR
TEXT Text 'description' Character value, *SAME, *BLANK Optional
Top

Change request description (CRQD)

Specifies the name and the library of the change request description being changed.

The name of the change request description can be qualified by one of the following library values:

*LIBL
All libraries in the library list for the current thread are searched until the first match is found.
*CURLIB
The current library for the job is searched. If no library is specified as the current library for the job, the QGPL library is used.
library-name
Specify the name of the library to be searched.

The possible values are:

change-request-description-name
Specify the name of the change request description being changed.

This is a required parameter.

Top

User profile (USRPRF)

Specifies the profile to use when the change request is submitted.

The possible values are:

*SAME
The value does not change.
*SBM
The user profile of the submitter is used when the change request is submitted.
*OWNER
The user profile that created the change request description is used when the change request is submitted.
Top

Problem identifier (PRBID)

Specifies the ID of the problem to be associated with this change request description. Problems with different origin systems can have the same identifier.

The possible values are:

*SAME
The value does not change.
*NONE
There is not a problem ID associated with this change request description.
problem-identifier
Specify the ID of the problem to be associated with the change request description.
Top

Problem Origin (PRBORG)

Specifies the origin system of the problem ID.

The possible network identifier values are:

*SAME
The value does not change.
*NETATR
The network ID is the same as the one defined in the network attributes for this system.
network-identifier
Specify a network ID.

The possible control point name value is:

*NETATR
The control point name is the same as the local control point name defined in the network attributes for this system.
control-point-name
Specify a control point name.
Top

Text 'description' (TEXT)

Specifies text that briefly describes the object. More information on this parameter is in the CL Reference book, Appendix A.

The possible values are:

*SAME
The value does not change.
*BLANK
Text is not specified.
'description'
Specify a maximum of 50 characters, enclosed in apostrophes.
Top

Examples

Example 1: Changing the Text Description in Your Own Library

CHGCRQD   CRQD(MYLIB/CHG001)  TEXT('This is the change')

This command changes the text description for the change request description in MYLIB with the name CHG001.

Example 2: Changing the Associated Problem ID

CHGCRQD   CRQD(*LIBL/CHG002)  PRBID(1234567890)

This command changes the associated problem ID to the change request description in the library list named CHG002.

Top

Error messages

*ESCAPE Messages

CPF969B
Change request description changed, but warnings exist.
CPF969C
Not authorized to change USRPRF.
Top