CA Dynam for VSE User Guide
CA Dynam for VSE User Guide CA Dynam for VSE User Guide
DYNINFO Parameter List For GV calls, tape volumes which match the characters before the leading space are returned. On the call after the last matching volser has been returned, DYNRTCOD 24 is set. DYNRTCOD 6 is set for volumes with no active files (scratches). A key of at least one nonblank character must be supplied, otherwise DYNRTCOD 32 (SYNTAX ERROR) and DYNERCOD 16 (VOLSER GENERIC KEY ALL SPACES) is set. For DD calls, it is used to request that the version of the tape data set which resides on a specific volume is returned. If the volume does not contain an active version of the data set, DYNRTCOD 8 is set. May not be specified in conjunction with DYNRQVER, DYNRQGEN or DYNRQGDG. DYNRQVSQ Optional for DD calls. Otherwise must be spaces. It may be specified in conjunction with version selectors (DYNRQVER, DYNRQGEN, DYNRQGDG, or DYNRQVOL). It is used to specify the starting volume sequence number for a multivolume tape file (relative to 1) or the relative extent sequence number for multiextent disk files (relative to 1). DYNRQVSQ is useful where DYNINFO is not large enough to hold all volumes or extents for a data set version. If a SD, GD, DD, or NG call results in DYNRTCOD being set to 28, set up a DD call for the data set with DYNRQVSQ set to one greater than the number of volumes retrieved so far. The DYNVBREC array is filled with as many volumes as exist and will fit, starting at this volume sequence number. DYGNVOL always contains the number of tape or disk entries actually returned for a specific call. DYGVOLS contains the total number of volumes or extents that exist for a data set version. DYNNVBRS indicates the number of tape volumes which will fit in DYNINFO. More than this number of disk entries will fit, as disk entries are smaller. If more exist than will fit, as many as will fit are returned, DYNRTCOD is set to 28, and DYNRTLEN is set to indicate the length that would have been required to accommodate all that exist, starting at the volume sequence number specified in DYNRQVSQ. (DYNRQVSQ is only valid for DD calls.) DYNRQFSQ DYNRQDVC Optional for DV calls. Otherwise must be spaces. It is used to indicate which file on a multifile tape volume is to be returned, relative to 1. If this file sequence does not exist, DYNRTCOD is set to 8. If this field is not set, the first active file version on the tape volume is returned. Optional for SD, GD, DD, and NG calls. Otherwise must be spaces. It is used to select the device class of data sets and generations to be retrieved from the Catalog. Selection values are as follows: (blank) T all data sets and generations TAPE and FI data sets and tape generations 10–14 User Guide
DYNINFO Parameter List D F DISK and FI data sets and disk generations FI data sets and all generations Any other value will cause DYNRTCOD 32 (SYNTAX ERROR) and DYNERCOD 28 (INVALID DEVICE CLASS) to be set. Note that a data set defined as FI will qualify as both disk and tape, and so FI data sets will be returned for DYNRQDVC = T or D. However, for FI data sets, only those versions actually created on tape will be returned for T and only those versions actually created on disk will be returned for D. FI data sets which have only versions of the excluded type will have the data set information returned, no version or volume information, and DYNRTCOD will be set to 4 (NO ACTIVE VERSIONS). DYNCBUFN DYNCATNM DYNEROPT Specifies the number of Catalog buffers to be allocated by Catalog Management. Minimum is two and default is twelve. Buffers are the same size as the Catalog control interval size, usually 1K. Specifies the DD name or DTF name to be used to access the Catalog. May be used to access a snapshot of the Catalog by restoring a backup tape and referring to the restored file by a name other than the active system Catalog. Defaults to CAICATL. DYNACC never intentionally aborts, but sets a return code and returns to the caller. If this field is set to D, on any significant error (DYNRTCOD > 32), DYNACC will produce snap dumps of areas of interest before returning. It is up to the caller to terminate processing. DYNINFO Return Fields DYNINFO DYNRTCOD Return Codes 0 Requested info has been returned. 4 DSN exists but has no active generations. 6 VOLSER exists but has no active files. 8 Requested version or volser does not exist. 12 Requested dsn or volser does not exist. 14 Catalog information missing. 16 Data set is password protected. 18 No more versions for dsn - NG. 20 No more dsns - SD or GD. 22 No more volumes for version - NX. Chapter 10: Accessing the Catalog 10–15
- Page 477 and 478: DYNCAT Commands 00 for tape cartrid
- Page 479 and 480: DYNCAT Commands ML L NO Medium long
- Page 481 and 482: DYNCAT Commands − − Tape volume
- Page 483 and 484: DYNCAT Commands VTOC Command Use th
- Page 485: DYNCAT Commands When initializing a
- Page 488 and 489: General Reporting−DYNPRINT Note:
- Page 490 and 491: General Reporting−DYNPRINT The on
- Page 492 and 493: General Reporting−DYNPRINT VER=nn
- Page 494 and 495: General Reporting−DYNPRINT Creati
- Page 496 and 497: General Reporting−DYNPRINT DYNPRI
- Page 498 and 499: General Reporting−DYNPRINT Compil
- Page 500 and 501: General Reporting−DYNPRINT The DY
- Page 502 and 503: Reporting on the Catalog Reporting
- Page 504 and 505: Reporting on the Catalog SELECT=ALL
- Page 506 and 507: Reporting on the Catalog SELECT Opt
- Page 508 and 509: Reporting on the Catalog Invoking t
- Page 510 and 511: Displaying the VTOC−DYNVTOC Displ
- Page 512 and 513: Displaying the VTOC−DYNVTOC // JO
- Page 515 and 516: Chapter 10: Accessing the Catalog T
- Page 517 and 518: Using DYNACC The service module is
- Page 519 and 520: DYNINFO Parameter List The macro ha
- Page 521 and 522: DYNINFO Parameter List To Request g
- Page 523 and 524: DYNINFO Parameter List 28 insuffici
- Page 525 and 526: DYNINFO Parameter List Return codes
- Page 527: DYNINFO Parameter List If the OE ca
- Page 531 and 532: DYNACC User Exits DYNACC User Exits
- Page 533 and 534: Test Program Generator - DYNATEST W
- Page 535 and 536: Test Program Generator - DYNATEST F
- Page 537 and 538: DYNACC Version 2 Parameter List Con
- Page 539 and 540: DYNACC Version 2 Parameter List Con
- Page 541 and 542: DYNACC Version 2 Parameter List Con
- Page 543 and 544: DYNACC Version 2 Parameter List Con
- Page 545: DYNACC Version 2 Parameter List Con
- Page 548 and 549: AUDIT Data Set Browse Selection Pan
- Page 550 and 551: AUDIT Data Set Directory Panel—Al
- Page 552 and 553: AUDIT Data Set Directory Panel—CA
- Page 554 and 555: AUDIT Data Set Detail Panel—DYNAM
- Page 556 and 557: AUDIT Data Set Directory Panel—CA
- Page 558 and 559: AUDIT Data Set Directory Panel—CA
- Page 560 and 561: AUDIT Data Set Detail Panel—CA Dy
- Page 562 and 563: CAIAUDIT in Command Mode DSN=1|2 Sp
- Page 564 and 565: Printable Fields Name Length Descri
- Page 567 and 568: Chapter 12: Maintaining and Reporti
- Page 569 and 570: Maintaining the Audit Trail File
- Page 571 and 572: AUDTUTIL Control Statement Syntax A
- Page 573 and 574: Maintenance Commands Note: • The
- Page 575 and 576: Maintenance Commands Backing up the
- Page 577 and 578: Reporting Commands EXTENDED Default
DYNINFO Parameter List<br />
D<br />
F<br />
DISK and FI data sets and disk generations<br />
FI data sets and all generations<br />
Any other value will cause DYNRTCOD 32 (SYNTAX ERROR) and DYNERCOD 28<br />
(INVALID DEVICE CLASS) to be set.<br />
Note that a data set defined as FI will qualify as both disk and tape, and so FI<br />
data sets will be returned <strong>for</strong> DYNRQDVC = T or D. However, <strong>for</strong> FI data sets,<br />
only those versions actually created on tape will be returned <strong>for</strong> T and only<br />
those versions actually created on disk will be returned <strong>for</strong> D. FI data sets<br />
which have only versions of the excluded type will have the data set<br />
in<strong>for</strong>mation returned, no version or volume in<strong>for</strong>mation, and DYNRTCOD will<br />
be set to 4 (NO ACTIVE VERSIONS).<br />
DYNCBUFN<br />
DYN<strong>CA</strong>TNM<br />
DYNEROPT<br />
Specifies the number of Catalog buffers to be allocated by Catalog<br />
Management. Minimum is two and default is twelve. Buffers are the same size<br />
as the Catalog control interval size, usually 1K.<br />
Specifies the DD name or DTF name to be used to access the Catalog. May be<br />
used to access a snapshot of the Catalog by restoring a backup tape and<br />
referring to the restored file by a name other than the active system Catalog.<br />
Defaults to <strong>CA</strong>I<strong>CA</strong>TL.<br />
DYNACC never intentionally aborts, but sets a return code and returns to the<br />
caller. If this field is set to D, on any significant error (DYNRTCOD > 32),<br />
DYNACC will produce snap dumps of areas of interest be<strong>for</strong>e returning. It is up<br />
to the caller to terminate processing.<br />
DYNINFO Return Fields<br />
DYNINFO DYNRTCOD Return Codes<br />
0 Requested info has been returned.<br />
4 DSN exists but has no active generations.<br />
6 VOLSER exists but has no active files.<br />
8 Requested version or volser does not exist.<br />
12 Requested dsn or volser does not exist.<br />
14 Catalog in<strong>for</strong>mation missing.<br />
16 Data set is password protected.<br />
18 No more versions <strong>for</strong> dsn - NG.<br />
20 No more dsns - SD or GD.<br />
22 No more volumes <strong>for</strong> version - NX.<br />
Chapter 10: Accessing the Catalog 10–15