Print Internal Data (PRTINTDTA)
| Where allowed to run: All environments (*ALL) Threadsafe: No |
Parameters Examples Error messages |
The Print Internal Data (PRTINTDTA) command is used primarily for problem analysis tasks. It writes the machine internal data to a spooled printer file. The data is used to service the system.
Restrictions:
- This command is shipped with public *EXCLUDE authority and the QPGMR, QSYSOPR, QSRV, and QSRVBAS user profiles have private authorities to use the command.
- To use this command, you must have service (*SERVICE) special authority, or be authorized to the Service dump function of IBM i through System i Navigator's Application Administration support. The Change Function Usage (CHGFCNUSG) command, with a function ID of QIBM_SERVICE_DUMP, can also be used to change the list of users that are allowed to perform dump operations.
- The command must be issued from within the job with internal data being printed, or the issuer of the command must be running under a user profile which is the same as the job user identity of the job with internal data being printed, or the issuer of the command must be running under a user profile which has a job control (*JOBCTL) special authority. The job user identity is the name of the user profile by which a job is known to other jobs. It is described in more detail in the Work Management Guide.
- This command is intended to be used only at the direction of your service representative.
| Top |
Parameters
| Keyword | Description | Choices | Notes |
|---|---|---|---|
| TYPE | Type of data | *DMP, *INTCFG, *NOTES, *JOB | Required, Positional 1 |
| DMPID | Dump identifier | Character value, *NONE, *ALL | Optional |
| PERIOD | Time period for internal data | Element list | Optional |
| Element 1: Start time and date | Element list | ||
| Element 1: Beginning time | Time, *AVAIL | ||
| Element 2: Beginning date | Date, *CURRENT | ||
| Element 2: End time and date | Element list | ||
| Element 1: Ending time | Time, *AVAIL | ||
| Element 2: Ending date | Date, *CURRENT | ||
| JOB | Job name | Single values: *, *SVRTYPE Other values: Qualified job name |
Optional |
| Qualifier 1: Job name | Name | ||
| Qualifier 2: User | Name | ||
| Qualifier 3: Number | 000000-999999 | ||
| SLTTHD | Thread ID to include | Single values: *ALL, *SELECT Other values (up to 20 repetitions): Hexadecimal value |
Optional |
| SVRTYPE | Server type | Single values: *NONE Other values (up to 5 repetitions): Generic name, name |
Optional |
| Top |
Type of data (TYPE)
Specifies the type of data to be printed.
This is a required parameter.
- *DMP
- The data to print was dumped by a previously issued Dump Job Internal (DMPJOBINT) command or by the machine when it was processing a device error or object damage. The dump identifier of the data or *ALL must be specified for the Dump identifier (DMPID) parameter.
- *INTCFG
- The machine internal configuration and resource information is printed.
- *NOTES
- The notes portion of the machine internal data, for the period specified for the Time period for internal data (PERIOD) parameter, is printed.
- *JOB
- The data to be printed is for the job specified for the JOB parameter.
| Top |
Dump identifier (DMPID)
Specifies, for internal dumps only, the dump identifiers associated with the machine internal data that is printed. This parameter must be specified only if *DMP is specified on the Type of data (TYPE) parameter; otherwise, it is ignored.
- *NONE
- No dump identifier is specified.
- *ALL
- The dump portion of the machine internal data, for the period specified on the Time period for internal data (PERIOD) parameter, is printed.
- character-value
- Specify the dump identifier of the dump output that is printed. The identifier specified must contain 8 characters.
| Top |
Time period for internal data (PERIOD)
Specifies the period of time for which the notes or dump portion of the machine internal data is printed. This parameter is valid only if *NOTES is specified for the Type of data (TYPE) parameter or if *DMP is specified on the TYPE parameter and *ALL is specified for the Dump identifier (DMPID) parameter; otherwise, it is ignored.
Element 1: Start time and date
Element 1: Beginning time
- *AVAIL
- The notes or dump data that are available from the beginning date to the ending date (or for the current day only) are printed.
- time
- Specify the beginning time for the specified beginning date for which you want the notes or dump data printed. The time can be specified with or without a time separator:
- Without a time separator, specify a string of 4 or 6 digits (hhmm or hhmmss) where hh = hours, mm = minutes, and ss = seconds.
- With a time separator, specify a string of 5 or 8 digits where the time separator specified for your job is used to separate the hours, minutes, and seconds. If you enter this command from the command line, the string must be enclosed in apostrophes. If a time separator other than the separator specified for your job is used, this command will fail.
Element 2: Beginning date
- *CURRENT
- The notes or dump data that are available for the current day and between the specified beginning and ending times (if specified) are printed.
- date
- Specify the beginning date for which you want the notes or dump data printed. The job date format must be used.
Element 2: End time and date
Element 1: Ending time
- *AVAIL
- The notes or dump data available from the beginning date to the ending date (or for the current day only) are printed.
- time
- Specify the ending time for the specified ending date for which you want the notes or dump data printed. See the Beginning time description on this parameter for details about how time must be specified.
Element 2: Ending date
- *CURRENT
- The notes or dump data available for the current day and between the specified starting and ending times (if specified) are printed.
- date
- Specify the ending date for which you want the notes or dump data printed. The system date format must be used.
| Top |
Job name (JOB)
Specifies the qualified name of the job for which the data will be dumped. This parameter must be specified only if *JOB is specified for the Type of data (TYPE) parameter; otherwise, it is ignored.
Single values
- *
- The job that issued this command is the job that will be dumped.
- *SVRTYPE
- All jobs whose server type matches the server type attribute specified for the Server type (SVRTYPE) parameter will be dumped.
Qualifier 1: Job name
- name
- Specify the name of the job to be dumped.
Qualifier 2: User
- name
- Specify the user name that identifies the user profile under which the job was run.
Qualifier 3: Number
- 000000-999999
- Specify the system-assigned job number of the job to be dumped.
| Top |
Thread ID to include (SLTTHD)
Specifies a list of up to twenty threads whose information is to be included. This parameter must be specified only if *JOB is specified for the Type of data (TYPE) parameter; otherwise, it is ignored.
Single values
- *ALL
- All threads are dumped.
- *SELECT
- A list of thread identifiers is shown from which the user can select up to twenty to be included. *SELECT is only valid if the PRTINTDTA command is run in an interactive session; otherwise, an error message is sent.
Other values
- thread-identifier
- Specify the identifiers of up to twenty threads whose information is to be included. A thread identifier is a string of eight hexadecimal characters.
| Top |
Server type (SVRTYPE)
Specifies the server type attribute to identify the job to be dumped. This parameter must be specified only if *SVRTYPE is specified for the Job name (JOB) parameter; otherwise, it is ignored. All jobs whose server types matches this value will be dumped. For a list of possible server types, see Work management topic collection in the IBM i Information Center at http://www.ibm.com/systems/i/infocenter/
Single values
- *NONE
- No server types are dumped.
Other values
- generic-name
- Specifies the generic server type used to identify the job to be dumped. A generic name is a character string of one or more characters followed by an asterisk (*); for example, ABC*.
The asterisk substitutes for any valid characters. All jobs whose server type matches the specified generic prefix will be dumped.
- name
- Specify the server type used to identify the job to be dumped. A list of up to five server types can be specified.
| Top |
Examples
Example 1: Dump by Dump Identifier
PRTINTDTA TYPE(*DMP) DMPID(0102FA3C)
This command prints the job internal dump output that has a dump identifier of 0102FA3C.
Example 2: Dump by Job Identifier
PRTINTDTA TYPE(*JOB) JOB(201230/ALMATM/QPADEV0008)
SLTTHD(*ALL)
This command prints the job internal dump output for the selected job including all threads information.
Example 3: Dump a Job by Specifying Server Type
PRTINTDTA TYPE(*JOB) JOB(*SVRTYPE) SVRTYPE(QIBM_FTP)
This command prints the dump output for the job with the server type set to QIBM_FTP.
| Top |
Error messages
*ESCAPE Messages
- CPF3517
- Cannot specify *SELECT for the thread ID to include.
- CPF3519
- Cannot start service function.
- CPF6801
- Command prompting ended when user pressed &1.
- CPF98A2
- Not authorized to &1
| Top |