CA Dynam for VSE User Guide
CA Dynam for VSE User Guide CA Dynam for VSE User Guide
Test Program Generator - DYNATEST DYNACC Version 2 differs in DYNAEXIT processing from Version 1 in the following way: For Version 1, R0 on entry pointed to an area containing the callers registers R2 through R15. It should be noted that R0 now points to the save area containing all registers. The user needs to note the change to an IBM standard save area format and the consequent change in offsets to particular registers. This change will only impact callers using Version 2 parameter lists, as a Version 1 parameter list will cause the original service module to be invoked, which will continue to store the registers in the old manner. DYNEEXIT Catalog Logical Error Exit This exit is activated by including a user exit module called DYNEEXIT with the DYNACC root module when the user application program is link edited. Upon entry to the user's exit, the following conditions will exist: R0 R1 R2 R13 R14 R15 points to the save area provided by the caller on entry to DYNACC. This is assumed to be a standard format save area of 72 bytes. DYNACC stores the caller's registers R14 through R12, starting at offset decimal 12 on entry from the calling program. This save area may be used by the exit to obtain addressability to code and data in the caller's program. points to the Catalog Management parameter list. contains the Catalog Management function code. points to a standard format save area in which the exit must save its registers on entry and restore them on exit. The first three words contain save area chain pointers and should not be changed. will point to the return address in CA Dynam. will point to the user exit entry point and may be used to obtain addressability. Test Program Generator - DYNATEST DYNATEST Functions DYNATEST is a macro which generates an assembler program to access the CA Dynam Catalog using either the Version 1 or Version 2 format parameter list. The program is executable either on VM or VSE. 10–18 User Guide
Test Program Generator - DYNATEST While DYNACC operation is system independent, the program generated by DYNATEST requests operating system services using standard interfaces; therefore the program only executes on the operating system for which it was generated. DYNATEST is intended to demonstrate how to use DYNACC Version 2.0. It also illustrates the differences between DYNACC Version 1, as shipped with CA Dynam 5.3, and DYNACC Version 2, as shipped with CA Dynam 5.5, or higher. DYNATEST can generate a program which calls either version of DYNACC correctly. When a retrieval which executes correctly on Version 1 is repeated using Version 2, identical results should be achieved, but the performance advantages of Version 2 should be apparent. DYNATEST can also be used to experiment with the effect of changing various parameters such as the number of volumes which may be accommodated in DYNINFO so that the effect on EXCP counts may be observed. DYNATEST Syntax The macro has the following syntax: name DYNATEST [ AEXIT=YES|NO, ] [ BUFN=nnnn, ] [ CATN=dtfname, ] [ DSN=dsn ] [ DVC=D|T|F, ] [ EEXIT=NO|YES, ] [ EROPT=D ] [ FLAT=NO|YES, ] [ FSQ=nnnn, ] [ GDG=xxxxxxxx, ] [ GEN=nnn, ] [ INFO=YES|NO, ] [ NCALLS=nnnnnn, ] [ NVBRS=nnnn, ] [ PCOMM=NO|YES, ] [ PSW=xxxxxxxx, ] [ REQ=SD|GD|DD|SV|GV|DV|CC|VC, ] [ SYSTEM=DOS|CMS, ] [ V=2|1, ] [ VER=nnn, ] [ VOL=xxxxxx, ] [ VSQ=nnnn, ] The first value specified after the equals sign is the default. Chapter 10: Accessing the Catalog 10–19
- 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 and 528: DYNINFO Parameter List If the OE ca
- Page 529 and 530: DYNINFO Parameter List D F DISK and
- Page 531: DYNACC User Exits DYNACC User Exits
- 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
- Page 579 and 580: Reporting Commands The following jo
- Page 581 and 582: Reporting Commands FIELDS Command T
Test Program Generator - DYNATEST<br />
DYNACC Version 2 differs in DYNAEXIT processing from Version 1 in the<br />
following way: For Version 1, R0 on entry pointed to an area containing the<br />
callers registers R2 through R15. It should be noted that R0 now points to the<br />
save area containing all registers. The user needs to note the change to an<br />
IBM standard save area <strong>for</strong>mat and the consequent change in offsets to<br />
particular registers. This change will only impact callers using Version 2<br />
parameter lists, as a Version 1 parameter list will cause the original service<br />
module to be invoked, which will continue to store the registers in the old<br />
manner.<br />
DYNEEXIT Catalog Logical Error Exit<br />
This exit is activated by including a user exit module called DYNEEXIT with the<br />
DYNACC root module when the user application program is link edited. Upon<br />
entry to the user's exit, the following conditions will exist:<br />
R0<br />
R1<br />
R2<br />
R13<br />
R14<br />
R15<br />
points to the save area provided by the caller on entry to DYNACC. This is<br />
assumed to be a standard <strong>for</strong>mat save area of 72 bytes. DYNACC stores the<br />
caller's registers R14 through R12, starting at offset decimal 12 on entry from<br />
the calling program. This save area may be used by the exit to obtain<br />
addressability to code and data in the caller's program.<br />
points to the Catalog Management parameter list.<br />
contains the Catalog Management function code.<br />
points to a standard <strong>for</strong>mat save area in which the exit must save its registers<br />
on entry and restore them on exit. The first three words contain save area<br />
chain pointers and should not be changed.<br />
will point to the return address in <strong>CA</strong> <strong>Dynam</strong>.<br />
will point to the user exit entry point and may be used to obtain addressability.<br />
Test Program Generator - DYNATEST<br />
DYNATEST Functions<br />
DYNATEST is a macro which generates an assembler program to access the <strong>CA</strong><br />
<strong>Dynam</strong> Catalog using either the Version 1 or Version 2 <strong>for</strong>mat parameter list.<br />
The program is executable either on VM or <strong>VSE</strong>.<br />
10–18 <strong>User</strong> <strong>Guide</strong>