|Applying Zaps to the SAS/C Software Products|
The APPLYZAP utility can be invoked with the options shown in Table 3.2. On OS/390, the options are specified in the PARM string. On VM, the options are specified as command line options.
|Options||Negative||Default||Short Form *|
|FILEDEF||NOFILEDEF||NOFILEDEF||-F VM ONLY|
* Replace the dash (-) with the NOT sign (!) to negate
Valid APPLYZAP control statements
include NAME, VER, REP, IDRDATA, LOG, ALIAS, GO, EXIT, the comment statement
(*), the IEBUPDTE control card (./), and the additional APPLYZAP commands
as discussed below.
systemfunction. See the SAS/C Library Reference, Volume 1, Second Edition for further details on the
|Input and Output Files|
As shown in Table 3.3, several files are needed during each execution of APPLYZAP. Under OS/390, the name of a file is simply a DDname that must be defined in the JCL. Under VM, the name of the file is a filename and a filetype. The only exception to this rule is the SYSZLIB file. SYSZLIB is a DDname under OS/390 and VM. In this document, a file is referred to only by its DDname or VM Filename.
|DDname or VM Filename||VM Filetype||File Use|
|SYSZIN||ZAP||standard input file for APPLYZAP. All APPLYZAP statements are taken from this unless the INPUT(zname) option has been used or an APPLY command is being processed.|
|SYSZLIB||***||DDname that defines a PDS under OS/390 or a MACLIB under VM where zaps can be found. This DDname is used for the INPUT option and the APPLY command.|
|SYSZOUT||LISTING||standard output file for APPLYZAP. All APPLYZAP messages are written to this file.|
|SYSPRINT||LISTING||standard output file for the zap utilities and the linkage-editor utility.|
|ZAPPED||MACLIB||log of applied zaps (by module name). This is a PDS under OS/390 and a MACLIB under VM.|
|SYSZRPT||LISTING||output from the REPORT option (which produces a list of zaps applied during a run) or REPORT command (which can be used to produce a list of zaps that were previously applied). This is a list of currently applied zaps.|
|SYSZLIN||TEXT||output of the linkage editor (temporary file).|
|SYSIN||ZAP||actual zap sent to the zap utility (temporary file).|
|libname||TXTLIB, TEXT, LOADLIB, MODULE, or A||identifies the SAS/C library containing the member or members to be zapped. Valid library names can be found in the APPLYZAP procedure catalogued under OS/390 or the APPLYZAP EXEC under VM.|
APPLYZAP processes one zap at a time, each zap having one or more zap segments. A zap segment begins with a NAME statement and ends with an IDRDATA (OS/390) or LOG (VM) statement. APPLYZAP validates all CHECKSUMs, ensures that the zap has not been previously applied, ensures that all VER statements verify, ensures that all prerequisite zaps have been applied, applies the zap, generates any necessary diagnostics, and then continues to the next zap. If the zap has already been applied, then APPLYZAP issues a warning and continues to the next zap. If a CHECKSUM does not validate, or if any one of the VER statements does not verify, or if a prerequisite zap has not been applied, then an error is issued and APPLYZAP continues to the next zap (provided that the NOERROR option was not specified).
Zaps are processed regardless of the results of previous zaps, unless a zap utility returns a fatal error or NOERROR is specified. Upon termination, APPLYZAP will generate an appropriate error message and return code.
Top of Page
Copyright © 2001 by SAS Institute Inc., Cary, NC, USA. All rights reserved.