Print Internal Data (PRTINTDTA)

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 Operating System through iSeries 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 iSeries service representative.

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.

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.

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.

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.

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.

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 information in the iSeries Information Center at http://www.ibm.com/eserver/iseries/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.

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 by Task Name

PRTINTDTA   TYPE(*TASK)  TASK(MSCP)

This command prints the dump output for the task named MSCP.

Example 4: 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.