22.12.2012 Views

z/TPF Program Management - IBM

z/TPF Program Management - IBM

z/TPF Program Management - IBM

SHOW MORE
SHOW LESS

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.

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

Saved successfully!

Ooh no, something went wrong!