Analyze Problem (ANZPRB)
| Where allowed to run: Interactive environments (*INTERACT *IPGM *IREXX *EXEC) Threadsafe: No |
Parameters Examples Error messages |
The Analyze Problem (ANZPRB) command allows you to analyze, create problem records for, or report problems that are not detected by the system. For example, you can analyze or report:
- Job or programming problems.
- Equipment or communications problems.
- Problems that made it necessary to do an initial program load (IPL) of the system again.
- Problems on a device or system not attached to your system.
Restriction: This command is shipped with public *EXCLUDE authority and the QPGMR, QSYSOPR, QSRV, and QSRVBAS user profiles have private authorities to use the command.
| Top |
Parameters
| Keyword | Description | Choices | Notes |
|---|---|---|---|
| ANZTYPE | Analysis type | *REMOTE, *LOCAL, *MENU | Optional, Positional 1 |
| RCPNAME | Remote control point | Name | Optional |
| NETID | Network ID | Name, *NETATR | Optional |
| USERID | User ID | Name | Optional |
| PASSWORD | Password | Character value, X'', *NONE | Optional |
| Top |
Analysis type (ANZTYPE)
Specifies the type of analysis. The default value, *MENU allows you to do local or remote analysis on a System i5 or to analyze problems on another system which is not a System i5. If you want to analyze problems on a local or remote System i5, you can bypass the initial menu by specifying *LOCAL or *REMOTE.
Note: You cannot do remote analysis if IBM System Manager for i is not installed.
This is a required parameter.
The possible values are:
- *MENU
- The Select Type of System menu is shown. You may choose to analyze problems on:
- This System i5
- Another System i5 that is enrolled as a service requester
- Another System i5that is not enrolled as a service requester
- Another system that is not a System i5
- *LOCAL
- Local analysis is selected. Problem analysis is done on this System i5.
- *REMOTE
- Remote analysis is selected. Problem analysis is done for another System i5 that is enrolled as a service requester.
| Top |
Remote control point (RCPNAME)
Specifies the remote control point name for the service requester system where the remote analysis is done.
Note: This parameter is valid only if *REMOTE is specified for the Analysis type prompt (ANZTYPE parameter).
| Top |
Network ID (NETID)
Specifies the network identifier (ID) for the service requester system where the remote analysis is done.
Note: This parameter is valid only if *REMOTE is specified for the Analysis type prompt (ANZTYPE parameter).
The possible values are:
- *NETATR
- The network ID of the service provider is used.
- network-ID
- Specify the network ID.
| Top |
User ID (USERID)
Specifies the user identifier (ID) used to access the remote system.
Note: This parameter is valid only if *REMOTE is specified for the Analysis type prompt (ANZTYPE parameter).
| Top |
Password (PASSWORD)
Specifies the password used to access the remote system.
Note: This parameter is valid only if *REMOTE is specified for the Analysis type prompt (ANZTYPE parameter).
The possible values are:
- *NONE
- No password is needed to access the remote system because the remote system has a security level of 10.
- password
- Specify the password.
| Top |
Examples
Example 1: Displaying the Menu
ANZPRB
This command shows the Analyze Problem menu.
Example 2: Starting Remote Analysis
ANZPRB ANZTYPE(*REMOTE)
This command shows the display which prompts for the remaining values of the command. After you specify the appropriate values, remote analysis begins.
Example 3: Accessing Remote System with User ID and Password
ANZPRB ANZTYPE(*REMOTE) RCPNAME(RCH38377) USERID(JON)
PASSWORD(MY1STPWD)
This command shows the display which prompts for the remaining values of the command. After you specify the appropriate values beyond the ones specified on the command example, remote analysis begins.
Example 4: Remote Analysis has Security Level of 10
ANZPRB ANZTYPE(*REMOTE) RCPNAME(RCH38377) USERID(JON)
This command is slightly different than the preceding example. The same display prompt appears; however, if PASSWORD is not specified, the system assumes that the remote system has a security level of 10, that is, it does not use passwords. After you specify the appropriate values beyond the ones specified on the command example, remote analysis begins.
Example 5: Displaying the Menu
ANZPRB ANZTYPE(*MENU)
This command shows a menu prompting you for the type of analysis to be done. The remaining parameters do not appear on the display.
Example 6: Starting Local Analysis
ANZPRB ANZTYPE(*LOCAL)
This command begins analysis on the local device. The remaining parameters do not appear on the display.
| Top |
Error messages
*ESCAPE Messages
- CPF2B01
- Problem analysis cannot continue because of an error in the program.
- CPF2B3C
- Licensed program &1 not installed.
- CPF9308
- Unable to complete problem analysis. Reason code &1.
| Top |