Previous Topic

Next Topic

Book Contents

Book Index

CTDUFPRT Parameters

The CTDUFPRT utility uses two levels of parameters for input. Basic parameters, (described in Table 257) indicate the file to be used, the type of records to be selected, and how the records are processed. The second level (described in Table 258) are parameters specific to the selected record type. These parameters, sub-parameters of the RECORD parameter, narrow the selection of records to be processed.

Table 257 Basic CTDUFPRT Parameters

Parameter

Description

FILE

File type. Valid values are:

  • ACT – Active User file
  • HST - History User file
  • MIG - Migration User file
  • PRM - Permanent User file

PRINT

Indicates whether to print selected records. Valid values are:

  • Yes - Print selected records to the file specified by the DATRACE DD statement. Default.
  • No - Do not print selected records. The number of selected records is printed to SYSPRINT.
  • Stat- Do not print selected records. The number of selected records is printed to SYSPRINT. If USER or SYSDATA records are selected, the total number of pages and lines in the selected reports are printed to SYSPRINT.

RECORD

Type of records to be selected. Valid values are:

  • B – backup control record
  • C – Centera clip record
  • D – CTDS record
  • E – INP record
  • G – MIGPART record
  • H – SYNCHRO record
  • I – index record
  • J – GENJLST record
  • K – RPS record
  • L – ruler record
  • M – migration control record
  • N – notepad record
  • O – object record
  • P – print control record
  • R – restore control record
  • S – SYSDATA record
  • T – RESTART record
  • U – user record
  • V – INV record

Note: If this parameter is not used

  • all record types are selected
  • other selection criteria are disabled
  • the number of records of each record type is printed
  • if PRINT=STAT, the total number of pages and lines is printed

For printing MASK RULERS, select L (ruler record) for the RECORD parameter and PRM (Permanent User file) for the FILE parameter.

PRINTFORM

Printing format. Valid values are:

  • DUMP     - Print the selected records in a SNAP dump format. Default.
  • REPORT - Print the selected record in a report format. PRINTFORM=REPORT can be specified for the User, SYSDATA or Index record types only. This parameter should be followed by several (at least one) FIELD parameters

FIELD

Record field name to be printed as a column in the output report. For more information on the fields available for printing, see the following tables:

  • For User record fields, see Table 259 below
  • For SYSDATA record fields, see Table 260 below
  • For Index record fields, see Table 261 below
  • For INP record fields, see Table 262 below
  • For NOTE record fields, see Table 262a below

    Table 258 Record-Type-Specific CTDUFPRT Selection Parameters

Parameter

Description

Record Types

BKPFROM

Earliest backup date of selected reports. Date format is mm/dd/yy, dd/mm/yy, or yy/mm/dd (depending on the site standard defined in the IOAPARM installation member).

S

BKPMIS

Backup mission name. This can be a specific value or a mask. Maximum length is eight characters.

B, S

BKPTO

Latest backup date of selected reports. Date format is mm/dd/yy, dd/mm/yy, or yy/mm/dd (depending on the site standard defined in the IOAPARM installation member).

S

Note: If BKPTO is omitted and BKPFROM is specified, all reports with backup date from BKPFROM are selected.

CATEGORY

Category of the report. This can be a specific value or a mask. Maximum length is 20 characters.

U

CDAM

CDAM data set name. This can be a specific value or a mask. Maximum length is eight characters.

I, S

DECFROM

Earliest decollation date and time of selected reports. Format is date,time. Only date can be specified. Date format is mm/dd/yy, dd/mm/yy, or yy/mm/dd (depending on the site standard defined in IOAPARM installation member). Time format is hh:mm:ss.

I, N, S, U

DECTO

Latest decollation date and time of selected reports. Format is date,time. Only date can be specified. Date format is mm/dd/yy, dd/mm/yy, or yy/mm/dd (depending on the site standard defined in IOAPARM installation member). Time format is hh:mm:ss.

I, N, S, U

Note: If DECTO is omitted and DECFROM is specified, all reports with decollation date from DECFROM are selected.

DEST

CTDS destination name. This can be a specific value or a mask. Maximum length is eight characters.

D

INDFILE

Index data set name. This can be a specific value or a mask. Maximum length is 44 characters.

I

INDNAME

Main index name. This can be a specific value or a mask. Maximum length is 20 characters.

E, I, V

JOBNAME

Job name.This can be a specific value or a mask. Maximum length is eight characters.

C, E, I, L, N, S, U, V

JOBID

Job number. This is a numeric value. Maximum length is seven digits.

I, N, S, U

MIGFROM

Earliest migration date of selected reports. Date format is mm/dd/yy, dd/mm/yy, or yy/mm/dd (depending on the site standard defined in IOAPARM installation member).

I, S

MIGMEDIA

Migration media name. This can be a specific value or a mask. Maximum length is eight characters.

I, S

MIGMIS

Migration mission name. This can be a specific value or a mask. Maximum length is eight characters.

M, S

MIGTO

Latest migration date of selected reports. Date format is mm/dd/yy, dd/mm/yy, or yy/mm/dd (depending on the site standard defined in IOAPARM installation member).

I, S

Note: If MIGTO is omitted and MIGFROM is specified, all reports with migration date from MIGFROM are selected.

PRTMIS

Print mission name. This can be a specific value or a mask. Maximum length is eight characters.

E, P, U

REPNAME

Report name. This can be a specific value or a mask. If blank spaces or apostrophes are included in the report name, the report name must be written between apostrophes and the apostrophes included in the report name must be doubled. Maximum length is 50 characters.

I, L, N, U, V

USER

User name. This can be a specific value or a mask. Maximum length is eight characters.

E, L, N, U, V

VOLSER

Serial number of the volume to which the report is migrated or backed up. This can be a specific value or a mask. Maximum length is six characters.

I, S

Table 259 User Record fields available for printing

Field name

Description

Column Width

USER

Recipient name

8

REPORT

Report name

25

JOBNAME

Job name

8

JOBID

Job ID

8

CATEGORY

Report category

20

DATE

Decollation date

8

TIME

Decollation time

5

PRINT-MISSIONS

First two print mission names

17

COPIES

Copies count to be used when the report is printed

6

FORM

Form to use when printing a report

8

CLASS

Output printing class

5

DEST

Remote printer destination (node and User ID)

17

WTR

External writer name

8

PAGES

Number of pages in a report

8

LINES

Number of lines in a report

10

REMARK

Remark

16

REMARK2

First additional remark

20

REMARK3

Second additional remark

20

RECORD-ID

Record ID (counter of the record)

16

ODATE

Report order date

8

VIEWS

Number of views by an online user

6

STATUS

Status of the report

6

Table 260 SYSDATA Record fields available for printing

Field name

Description

Column Width

JOBNAME

Job name

8

JOBID

Job ID

8

DATE

Decollation date

8

TIME

Decollation time

5

CDAM

Original CDAM name

44

MIG-MISSION

Migration mission name

11

MIG-CDAM

Migrated CDAM file name or Centera Clip ID

53

MIG-DATE

Migration Date

8

MIG-MEDIA

Migration media name

9

BKP-MISSIONS

First two backup mission names

17

BKP-DATE

Backup date

8

EXP-DATE

Expiration date

8

VOLUME

First volume of migrated or backup file

6

RECORD-ID

Record ID (counter of the record)

16

PAGES

Number of pages in report

8

LINES

Number of lines in report

10

FILEEXT

File extension in report

8

Table 261 Index Record fields available for printing

Field name

Description

Column Width

REPORT

Report name

25

JOBNAME

Job name

8

JOBID

Job ID

8

DATE

Decollation date

8

TIME

Decollation time

5

INDEX

Main Index name

20

INDFILE

Original Index file name

44

CDAM

Original CDAM name

44

MIG-INDFILE

Migrated Index file name or Centera Clip ID

53

MIG-DATE

Migration Date

8

MIG-MEDIA

Migration media name

9

VOLUME

First volume of migrated or backup file

6

RECORD-ID

Record ID (counter of the record)

16

Table 262 INP Record fields available for printing

Field name

Description

Column Width

PRINTMIS

Print mission name

8

JOBNAME

Job name

8

CRDATE

INP Record creation date

8

RECORD-ID

INP Record ID in hex format (Index record-id + INP record counter)

24

ST

Status flags in hex format (VSAPIFLG field in macro CTDVSA)

2

UF

Printed report User file type (A-Active, M-Migrated)

2

USER

Recipient name

8

UREC-ID

User record ID in hex format

16

UXKEY

Second part of User record key (JOBNAME, REPNAME or CATEGORY depending on the optional wish WD1164)

8

DECDATE

Report decollation date

8

INDNAME

Main Index name

20

INDVAL

Main Index value

50

Table 262a NOTE Record fields available for printing

Field name

Description

Column Width

NOTE-TYPE

Type of note

1

USERID

User who created the note

8

USERNAME

Recipient name

8

DATE

Date when the note was created

8

TIME

Time when the note was created

8

ODATE

Report order date

8

NOTE-TEXT

Textual content of the note

20

JOBNAME

Job name

8

COUNTER

Record ID

16

REPORT

Report name

50

Parent Topic

CTDUFPRT – Print data from Control-D user files