22.12.2012 Views

z/TPF Program Management - IBM

z/TPF Program Management - IBM

z/TPF Program Management - IBM

SHOW MORE
SHOW LESS

You also want an ePaper? Increase the reach of your titles

YUMPU automatically turns print PDFs into web optimized ePapers that Google loves.

@VERIFY<br />

(progcmt)<br />

appends a comment for the program specified by progname that is displayed in<br />

the output report, where progcmt is the text that is appended.<br />

@@progname<br />

specifies a program to patch or to move, where progname is the 4-character<br />

name of the program that you want to patch or move. <strong>Program</strong> names must<br />

begin with a letter (A–Z).<br />

Note: If you want to patch a program, you must load the program in the current<br />

@LOADSET control statement section before you can patch it. If you are<br />

moving an entry point, you must ensure that it is being loaded in the<br />

current @LOADSET control statement section.<br />

.objfile<br />

specifies the object file name, where objfile is the 4-character alphanumeric<br />

name of the object file (within the program) that you want to patch on the z/<strong>TPF</strong><br />

system. Object file names must begin with a letter (A–Z).<br />

rsa<br />

is the 1- to 6-digit hexadecimal relative starting address in the program or object<br />

file. The relative starting address specifies the offset into the program or object<br />

file where the patch will be applied.<br />

newdata<br />

is the new data (or patch) that will replace the old data in the program or object<br />

file, 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 program. If it does<br />

not, the data in the program is not changed and an error occurs. If it does, the<br />

data in the program is replaced by newdata. For example, this parameter can<br />

help to verify that your patch is starting at the correct relative 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 />

MOVe<br />

indicates that the single entry BSO specified by @@progname has been moved<br />

into another BSO. The BSO that @@progname has been moved to must be<br />

included in the same loadset.<br />

Note: If the E-type loader is used to move an entry point, you cannot activate<br />

another loadset that moves the entry point again. The loadset that<br />

moved the entry point first must be deactivated or accepted before the<br />

entry point can be moved again.<br />

Use the @VERIFY control statement to specify a program attribute table (PAT) that<br />

includes all of the programs being loaded. The loader determines if each program<br />

being loaded exists in the specified PAT.<br />

The following figure shows the syntax for the @VERIFY control statement section of<br />

the loader input file. In this figure, the double arrowhead (►►) indicates that the<br />

z/<strong>TPF</strong> offline loader input file control statements 153

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

Saved successfully!

Ooh no, something went wrong!