z/TPF Program Management - IBM
z/TPF Program Management - IBM
z/TPF Program Management - IBM
Create successful ePaper yourself
Turn your PDF publications into a flip-book with our unique Google optimized e-Paper software.
@DEFINE<br />
134 z/<strong>TPF</strong> <strong>Program</strong> <strong>Management</strong><br />
control statement section; that is, only the specific location is searched for the<br />
CTKX component. If the CTKX component is not found in the specific location,<br />
an error occurs.<br />
CWD<br />
is the value specified for the CWD parameter in the @DEFINE control<br />
statement section. If you do not specify a default location or a specific location,<br />
this is the only location that is searched.<br />
CTKX<br />
loads the image pointer record (CTKX) to the z/<strong>TPF</strong> system. When a new copy<br />
of CTKX is loaded, it is compared to the existing version. If the starting ordinal<br />
of a core image record (CIMR) or IPL component is different in the new copy of<br />
CTKX, or the allocated size is too small, that component must also be loaded.<br />
version<br />
is the 1- to 2-character alphanumeric version code for the CTKX component.<br />
.ext<br />
specifies an extension of the full program name as created by the linker, where<br />
ext is the appropriate extension. For example, if the linker creates a program<br />
called ctkx51.so, the .so portion of the name is optional.<br />
(progcmt)<br />
appends a comment to the CTKX component that is displayed in the output<br />
report, where progcmt is the text appended.<br />
@@CTKX<br />
patches the image pointer record (CTKX).<br />
Note: You must load the image pointer record (CTKX) in the current @CTKX<br />
control statement section before you can patch it.<br />
rsa<br />
is the 1- to 6-digit hexadecimal relative starting address in the CTKX<br />
component. The relative starting address specifies the offset into the CTKX<br />
component where the patch will be applied.<br />
newdata<br />
is the new data (or patch) that will replace the old data in the CTKX component,<br />
beginning at the relative starting address. The new data must be an even<br />
number of hexadecimal digits and cannot exceed 32 digits (16 bytes).<br />
valdata-olddata<br />
validates the data that is replaced by newdata, where olddata is an even<br />
number in hexadecimal format that does not exceed 32 digits (16 bytes). The<br />
data specified for olddata must match what is currently in the component. If it<br />
does not, the data in the component is not changed and an error occurs. If it<br />
does, the data in the component is replaced by newdata. For example, this<br />
parameter can help to verify that your patch is starting at the correct relative<br />
starting address.<br />
Note: The length of the data that you are validating can have fewer bytes or<br />
more bytes than the new data. If the validation is completed successfully,<br />
only the number of bytes in your new data will be replaced.<br />
Use the @DEFINE control statement to define system settings.