8.152 SF+ (Create a new shadow file)

8.152.1 Function

With the SF+ command a new shadow file for a certain dasd device (or for all dasd devices that have
shadow files) is created.

8.152.2 Syntax

Descriptive

Diagram

¬¬¬§¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬ÊÍ

8.152.3 Parameter

device

This specifies the device for which a new shadow file will be created.

*

Specifying an asterisk it is possible to create a (new) shadow file for all dasd
devices that have a shadow file defined in their configuration file definition
statements.

8.152.4 Examples

Example 1:

Create a new shadow file for device 0148.

HHC00013I Herc command: 'sf+ 0148'

HHC00320I 0:0148 CCKD file[1] 'D:/MVS/SHADOW/MVSRES_1.CCKD': shadow file succesfully added

HHC00333I 0:0148 size free nbr st reads writes l2reads hits switches

HHC00335I 0:0148 --------------------------------------------------------------------

HHC00336I 0:0148 [*] 21623269 0% 0 0 0 0 0 0

HHC00338I 0:0148 D:/MVS/DASD/MVSRES.CCKD

HHC00339I 0:0148 [0] 21621981 0% 0 rd 0 0 0

HHC00340I 0:0148 D:/MVS/SHADOW/MVSRES_*.CCKD

HHC00341I 0:0148 [1] 1288 0% 0 rw 0 0 0

Figure 280: SF+ command

8.153 SF- (Delete a shadow file)

8.153.1 Function

The SF- command removes a shadow file. Depending on the MERGE / NOMERGE / FORCE parameter
the changes are incorporated in the base file or discarded.

If MERGE is specified or defaulted then the contents of the current file is merged into the previous file, the
current file is removed and the previous file becomes the current file.

If NOMERGE is specified then the contents of the current file is discarded and the previous file becomes
the current file. However if the previous file is read-only then a new shadow file is created ("re-added")
and that becomes the current file.

The FORCE option is required when doing a merge to a base file and the base file is read-only because
the 'ro' option was specified on the device configuration statement.

8.153.2 Syntax

Descriptive

-

Diagram

- ¬¬¬§¬¬¬ ¬¬¬§¬¬¬¦¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¦¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬¬ÊÍ

8.153.3 Parameter

device

This specifies the device for which a shadow file should be deleted.

*

Specifying an asterisk it is possible to remove a shadow file for all dasd devices
that have shadow files.

MERGE

The MERGE parameter (which is the default) specifies that all changes or updates
that have been made to the shadow file will be committed.

NOMERGE

The NOMERGE parameter specifies that all changes or updates that have been
made to the shadow file will be discarded instead of being committed.

FORCE

The FORCE parameter is used when doing a merge to a base file that is read-only
because the 'ro' option was specified on the device configuration statement.