CA Dynam for VSE User Guide

CA Dynam for VSE User Guide CA Dynam for VSE User Guide

supportcontent.ca.com
from supportcontent.ca.com More from this publisher
03.03.2015 Views

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

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>

Hooray! Your file is uploaded and ready to be published.

Saved successfully!

Ooh no, something went wrong!