Print Directory Information (PRTDIRINF)

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

The Print Directory Information (PRTDIRINF) command is used to print directory information for objects in the Integrated File System that was collected by the Retrieve Directory Information (RTVDIRINF) command. A spooled file with file name QPEZDIR goes to the spool queue associated with the job using this command.

Restrictions:

Top

 

Parameters

Keyword Description Choices Notes
RPTTYPE Type of report *DIR, *OBJ, *OWN Required, Positional 1
INFFILEPFX Information file prefix Simple name, *LAST Optional
INFLIB Information library Name, *LAST Optional
OWNER Owners Generic name, name, *ALL Optional
OBJ Objects Path name, *ALL, *NONE Optional
OBJTYPE Object types Single values: *ALL
Other values (up to 60 repetitions): *ALRTBL, *AUTL, *BLKSF, *BNDDIR, *CFGL, *CHTFMT, *CHRSF, *CLD, *CLS, *CMD, *CNNL, *COSD, *CRG, *CRQD, *CSI, *CSPMAP, *CSPTBL, *CTLD, *DDIR, *DEVD, *DIR, *DOC, *DSTMF, *DTAARA, *DTADCT, *DTAQ, *EDTD, *EXITRG, *FCT, *FIFO, *FILE, *FLR, *FNTRSC, *FNTTBL, *FORMDF, *FTR, *GSS, *IGCDCT, *IGCSRT, *IGCTBL, *IMGCLG, *IPXD, *JOBD, *JOBQ, *JOBSCD, *JRN, *JRNRCV, *LIB, *LIND, *LOCALE, *MBR, *MEDDFN, *MENU, *MGTCOL, *MODD, *MODULE, *MSGF, *MSGQ, *M36, *M36CFG, *NODGRP, *NODL, *NTBD, *NWID, *NWSD, *OUTQ, *OVL, *PAGDFN, *PAGSEG, *PDG, *PGM, *PNLGRP, *PRDAVL, *PRDDFN, *PRDLOD, *PSFCFG, *QMFORM, *QMQRY, *QRYDFN, *RCT, *SBSD, *SCHIDX, *SOCKET, *SPADCT, *SQLPKG, *SQLUDT, *SRVPGM, *SSND, *STMF, *SVRSTG, *SYMLNK, *S36, *TBL, *TIMZON, *USRIDX, *USRPRF, *USRQ, *USRSPC, *VLDL, *WSCST 		Optional
SUBTREE Directory subtree *ALL, *NONE Optional
MINSIZE Smallest size 0-99999, 0 Optional
SORT Sort by *SIZE, *OWNER, *LSTCHG, *NAME Optional
INCPATH Include path names *ALL, *NONE Optional

Top

 

Type of report (RPTTYPE)

Specifies the type of report to print.

This is a required parameter.

*DIR

A report of space being used by each directory is printed. Information will include a total size for the outermost directory and all nested subdirectories. Information for each subdirectory will include the total of space for just the subdirectory and will not include space for objects in any directories contained in the subdirectory.

*OBJ

A report of object information for files and directories is printed.

*OWN

A report of the user profile (owner) information for files and directories is printed.

Top

 

Information file prefix (INFFILEPFX)

Specifies the file name prefix of the database files that were created by the Retrieve Directory Information (RTVDIRINF) command to store the retrieved directory information.

*LAST

The database files created by the most recent invocation of the RTVDIRINF command will be used. Informational message CPI1E31 will be sent to the job log and will contain the name and library of the files used.

information-file-prefix

Specify the same file prefix as was specified on a previous invocation of the RTVDIRINF command. The RTVDIRINF command created multiple database files to store the retrieved directory information. If a file prefix is specified, a value other than *LAST must be specified for the INFLIB parameter.

Top

 

Information library (INFLIB)

Specifies the library that contains the database files that were created by the Retrieve Directory Information (RTVDIRINF) command to store the retrieved directory information.

*LAST

The library used by the most recent invocation of the RTVDIRINF command will be used to find the database files which contain the retrieved directory information. Informational message CPI1E31 will be sent to the job log and will contain the name and library of the files used.

library-name

Specify the name of the library that contains the database files created by a previous invocation of the RTVDIRINF command. If a library name is specified, a value other than *LAST must be specified for the INFFILEPFX parameter.

Top

 

Owners (OWNER)

Specify the names of the owners (user profiles) of the objects to print information about.

*ALL

The report contains information about objects owned by any user profile.

owner-name

Specify the user profile that owns the objects to print information about.

generic-name

Specify the generic user profile that owns the objects to print information about. 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. A generic name specifies all user profiles with names that begin with the generic prefix.

Top

 

Objects (OBJ)

Specifies the names of the objects to print information about.

*ALL

If you specify an owner (OWNER parameter), all objects owned by the specified owner are included. If OWNER(*ALL) is specified, all objects are included in the report.

*NONE

No detail object information is included in the report, just a total size of owned objects, if *NONE is specified for Object (OBJ) parameter and *OWN is specified for the Type of report (RPTTYPE) parameter.

object-name

The object information is included only for the objects specified by the given name. If an owner is specified (OWNER parameter), only the objects meeting the owner criteria and that match the given name are included.

generic-name

The object information is included only for the objects that match the specified generic name. 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. A generic name specifies all objects with names that begin with the generic prefix. If an owner is specified (OWNER parameter), only the objects meeting the owner criteria and that match the given generic name are included.

Top

 

Object types (OBJTYPE)

Specifies the object types to print information about. If the OWNER or OBJ parameters were specified with a value other than *ALL, the owner and object name criteria must also be met.

Single values

*ALL

Information about objects of all types is printed.

Other values (up to 60 repetitions)

object-type

Information about objects of the type(s) specified is printed.

Top

 

Directory subtree (SUBTREE)

Whether to print subdirectories statistics in the report or not.

*ALL

Statistics are included for all subdirectories within the directory processed by the Retrieve Directory Information (RTVDIRINF) command.

*NONE

Statistics are included only for objects in the directory processed by the Retrieve Directory Information (RTVDIRINF) command.

Top

 

Smallest size (MINSIZE)

Specifies the size of the smallest object to include.

0

All objects are included regardless of size.

size

Specify size in number of kilobytes.

Top

 

Sort by (SORT)

Specifies the order in which the information should be sorted.

*SIZE

Information is sorted by object size, from largest to smallest.

*OWNER

The information is sorted in alphabetical order by owner name.

*LSTCHG

The information is sorted by last-change date with the oldest information first.

*NAME

Information is sorted by object name, names are listed in alphabetical order.

Top

 

Include path names (INCPATH)

Specifies if the report will include the path where the objects reside. If *NONE is specified for Object (OBJ) parameter and *OWN is specified for the Type of report (RPTTYPE) parameter, this parameter will be ignored.

*ALL

Paths are included in the report.

*NONE

Paths are not included in the report.

Top

 

Examples

Example 1: Print Information, Grouped by Owner, for Most Recent RTVDIRINF 

 PRTDIRINF   RPTTYPE(*OWN)  INFFILEPFX(*LAST)  INFLIB(*LAST)
            OWNER(*ALL) OBJ(*ALL) OBJTYPE(*ALL)  SORT(*SIZE)

This command prints an owner report from the database file created by the most recent invocation of the Retrieve Directory Information (RTVDIRINF) command. Information in the report will be included for all objects, grouped by their owner. The information is sorted by object size and sent to the printer file QPEZDIR.

Example 2: Print a Directory Report 

 PRTDIRINF   RPTTYPE(*DIR)  INFFILEPFX(MYROOTDIR)
            INFLIB(QUSRSYS)  SUBTREE(*ALL)

This command prints a directory report from database file MYROOTDIRO and MYROOTDIRD created by a prior invocation of the Retrieve Directory Information (RTVDIRINF) command. If information was collected for subdirectories by the RTVDIRINF command, that information will be included in the directory report. The information is sent to the printer file QPEZDIR.

Top

 

Error messages

*ESCAPE Messages

CPF2110

Library &1 not found.

CPF1ED2

File &1 is in use and cannot be accessed.

CPF1ED5

File prefix &1 or library &2 not found in QAEZDBFILE.

CPF1ED6

File &1 in library &2 not found.

CPF1ED9

Retrieved directory information not complete.

CPF1EEC

Not authorized to file &1.

CPF1E99

Unexpected error occurred.

Top