Previous Topic: Command Structures in the Command Language

Next Topic: MODE=LIVE|SIMULATE


SET Statement

The following section describes the SET statement.

SET  [MODE=LIVE|SIMULATE]
[,PREEXIT=exitname]
 [,POSTEXIT=exitname]
 [,PERCENT=100|n]
 [,BYPASS=0|n]
 [,SKIP=0|n]R	[,EXTRACT=0|n]
 [,DSNFILL=.|x]
 [,SECURITY=NONE|RACF|TOPSEC|ACF2]

The SET statement specifies options for the execution of the command structures that follow it. However, parameters on an EXAMINE statement will override those specified on a SET statement. Any SET statement which specifies MODE=SIMULATE causes the entire run to be in simulate mode even if MODE=LIVE is specified on another SET statement.

You can use the SET statement to establish default values for the compression run which are different from normal TCF default values. The following example shows how the SET statement works with EXAMINE statements:

1:	SCAN CAT=ICF.PAYROLL 	All of the records
2:	        EXAMINE
3:	SET PERCENT=30		Estab new default
4:	SCAN CAT=!IMS
5:	        EXAMINE		30% of the records
6:	SCAN CAT=!CICS7:
	        EXAMINE PERCENT=20	20% of the records
8:	SCAN CAT=ICF.PROD019:
	        EXAMINE		30% of the records

The EXAMINE statement in line 2 runs a test compression on all of the records in all of the data sets cataloged in ICF.PAYROLL because TCF processes all records by default. The SET statement in line 3 establishes a new default of running test compression on 30% of the records. The EXAMINE statement in line 5 runs a test compression on a 30% sample of the records in all of the data sets cataloged in catalogs which have a name ending in 'IMS'. The EXAMINE statement in line 7 runs a test compression on a 20% sample of the records in all of the data sets cataloged in catalogs which have a name ending in 'CICS' because PERCENT=20 is specified on it. The EXAMINE statement in line 9 runs a test compression on a sample of 30% of the records in all of the data sets cataloged in ICF.PROD01.

The SET statement is required if you want to use TCF's security interfaces. When used in this way, the SET statement should precede the first EXAMINE statement in the input stream, as in the following example:

SET SECURITY=ACF2, ...
 SCAN CAT=ICF.TESTCAT
EXAMINE PERCENT=20