Query Problem Status (QRYPRBSTS)
| Where allowed to run: All environments (*ALL) Threadsafe: No |
Parameters Examples Error messages |
The Query Problem Status (QRYPRBSTS) command retrieves problem status information from *IBMSRV (RETAIN) or from another system that is enlisted as a service provider.
Restriction: This command is shipped with public *EXCLUDE authority and the QPGMR, QSYSOPR, QSRV, and QSRVBAS user profiles have private authorities to use this command.
| Top |
Parameters
| Keyword | Description | Choices | Notes |
|---|---|---|---|
| PRBID | Problem identifier | Character value, *PMR | Required, Positional 1 |
| ORIGIN | Origin | Element list | Optional |
| Element 1: Network identifier | Communications name, *NETATR | ||
| Element 2: Control point name | Communications name, *NETATR | ||
| RMTCPNAME | Remote control point | Communications name, *IBMSRV, *SELECT | Optional |
| RMTNETID | Remote network identifier | Communications name, *NETATR | Optional |
| SRVID | Service number | Character value | Optional |
| BRANCH | Branch number | Character value, *SRVID | Optional |
| COUNTRY | Country or region number | Character value, *SRVID | Optional |
| AUTOPRBCRT | Auto problem create | *YES, *NO | Optional |
| Top |
Problem identifier (PRBID)
Specifies the problem identifier of the problem log entry. Problems with different system origins can have the same identifier. This parameter can be used with the ORIGIN parameter to select a single problem from a particular system.
- *PMR
- The service request is sent to IBM service support.
Note: A value must be specified for the Service number (SRVID) parameter when PRBID is *PMR.
- character-value
- Specify a problem identifier.
This is a required parameter.
| Top |
Origin (ORIGIN)
Specifies the node of the system from which the problem log entry originated. This parameter is used with the PRBID parameter to uniquely identify the problem.
Element 1: Network identifier
- *NETATR
- The LCLNETID value specified in the system network attributes is used.
- communications-name
- Specify a network identifier.
Element 2: Control point name
- *NETATR
- The LCLNETID value specified in the system network attributes is used.
- communications-name
- Specify a control point name.
| Top |
Remote control point (RMTCPNAME)
Specifies the destination of the service provider to whom the service request is sent.
- *IBMSRV
- The service request is sent to IBM service support.
- *SELECT
- A list of service providers is shown from which the user can select the destination the service request is sent to.
- communications-name
- Specify the name of the control point that is the destination of the request.
| Top |
Remote network identifier (RMTNETID)
Specifies the remote name of the service provider's network.
- *NETATR
- The service provider is in the local network.
- communications-name
- Specify the network name of the service provider to whom the request is sent.
| Top |
Service number (SRVID)
Specifies the service assigned number for the problem log entry. This number was assigned when the problem was reported to IBM service support.
- character-value
- Specify the service assigned number for the problem log entry.
| Top |
Branch number (BRANCH)
Specifies the branch number for the problem log entry. This number was assigned when the problem was reported to IBM service support.
- *SRVID
- The branch number on an existing problem log entry in the current system that contains the specified service number (SRVID parameter) will be used. If no problem log entry with the specified service number exists, a valid branch number must be specified.
- character-value
- Specify the three-digit branch number for the problem log entry. All three digits must be specified.
| Top |
Country or region number (COUNTRY)
Specifies the country or region number for the problem log entry. This number was assigned when the problem was reported to IBM service support.
- *SRVID
- The country or region number on an existing problem log entry in the current system that contains the specified service number (SRVID parameter) will be used. If no problem log entry with the specified service number exists, a valid country or region number must be specified.
- character-value
- Specify the three-digit country or region number for the problem log entry. All three digits must be specified.
| Top |
Auto problem create (AUTOPRBCRT)
Specifies whether a problem should automatically be created, if a problem does not exist on the system.
- *YES
- Create a problem.
- *NO
- Do not create a problem.
| Top |
Examples
Example 1: Querying Problem Status on Another System
QRYPRBSTS PRBID(1234567890) RMTCPNAME(SYSTEM99)
RMTNETID(IBMNETID) AUTOPRBCRT(*YES)
This command searches for the status of a specific problem on another system (SYSTEM99).
Example 2: Querying IBM Service
QRYPRBSTS PRBID(*PMR) RMTCPNAME(*IBMSRV) RMTNETID(*NETATR)
SRVID(23774) AUTOPRBCRT(*YES)
This command searches the IBM Service database for the status of PMR 23774.
| Top |
Error messages
*ESCAPE Messages
- CPF7AA7
- Problem &1 not found or in use.
- CPF7AD4
- Network ID &1 not in correct format.
- CPF7A84
- Query status request routed to different system than specified.
- CPF7A88
- Error indicated in reply to request.
- CPF7A9A
- Remote control point and network identifier not valid.
- CPF7A9B
- Problem &1 cannot be queried.
- CPF7A97
- Invalid service identifier.
- CPF7A98
- Service identifier not allowed.
- CPF7A99
- Query must be sent to *IBMSRV.
- CPF7B18
- Control point &1 not in correct format.
- CPF8C08
- Cannot specify *SELECT for the control point name.
- CPF8C09
- &1 not defined as a service provider.
- CPF8C24
- Error occurred while processing request.
- CPFC680
- Branch number not allowed.
- CPFC681
- Country or region number not allowed.
- CPFC682
- Branch number not valid.
- CPFC683
- Country or region number not valid.
*STATUS Messages
- CPZ7A80
- Sending query status request to &1.
| Top |