Previous Topic: ACF2ASM - Assembling the FDR, HCPAC0, CMS ModulesNext Topic: ACF2VSAM - Creating VSAM Databases


ACF2FIX - Applying CA ACF2 for z/VM Fixes

ACF2FIX applies CA ACF2 for z/VM fixes. Enter the following command to run this utility:


ACF2FIX      { fn ft fm }  [USING] { zfn zft zfm } [([options]
             {     ?    }          {  =   =   =  }
fn ft fm

File ID of the file to be zapped. Valid filetypes are:

zfn zft zfm

File ID of the fix file.

USING

Optional keyword.

options

Options that directs the output of the ZAP command. Valid options are:

NOPRINT

Directs the output to the terminal.

PRINT

Directs the output to the printer (the default).

?

Displays online help containing the syntax of this utility.

= = =

Duplicates the input fn ft, or fm names.

ACF2FIX Control Statements

ACFEXPAND

The ACFEXPAND control statement lets the ACF2FIX EXEC automatically increase the CSECT size of a TEXT. This control statement specifies the CSECT to expand and the required size of the TEXT. You do not need to use ZAPTEXT manually or calculate the difference between the current size and the required size of the TEXT. If the TEXT is already at the required length, you do not need an expansion. If you need to expand more than one CSECT in a TEXT, ACF2FIX supports multiple ACFEXPAND control statements or multiple parameters on a single control statement with comma delimiters.

CA ACF2 for z/VM Technical Support normally supplies these control statements with all fix files that require an expanded TEXT.

The syntax of the ACFEXPAND control statement is:

* ACFEXPAND csect size, ... ,csectn sizen)

The asterisk (*) is part of the control statement. Do not remove it.

csect

The IBM control section that you want to expand.

size

The new size, in hexadecimal, of the CSECT.

One example of the ACFEXPAND control statement is:

* ACFEXPAND HCPZZZ 1200
NAME HCPZZZ HCPZZZ
VER 1100 0000,0000
REP 1100 C1C3,C6F2
END

This statement checks to see of HCPZZZ is ‘1200’x bytes long. If it is, the fix applies. If not, it expands HCPZZZ to ‘1200’x bytes, then applies the fix.

ACFCHKSUM

The ACFCHKSUM control statement helps verify that you correctly typed in a hardcopy of a fix. ACF2FIX adds up all the numbers in the REP and VER control statements and compares it to the numbers specified in VERCHKSUM and REPCHKSUM. If you typed in a fix incorrectly, these numbers do not match the total calculated for the REP and VER control statements and you then need to reverify the REP and VER control statements for accuracy.

CA ACF2 for z/VM Technical Support normally supplies these control statements with all fix files that require you to key a fix in manually, such as when a fix i8s sent by FAX machine.

The syntax of the ACFCHKSUM control card is:

* ACFCHKSUM verchksum repchksum

The asterisk (*) is part of the control statement. Do not remove it. You can only specify one control statement. If you specify more than one, the last one overrides previous statements.

verchksum

Decimal number that is the total of all VER control cards in the zap. CA ACF2 for z/VM Technical Support supplies this number in the zap.

repchksum

Decimal number that is the total of all REP control cards in the zap. CA ACF2 for z/VM Technical Support supplies this number in the zap.