STORE and TurboSTORE/iX Products Manual (B5151-90003)

98 Chapter6

STORE and TurboSTORE/iX Command Options

STORE Options

ONLINE option with START or END), the ﬁles being stored remain available and can be

modiﬁed while the backup is occurring. Refer to Chapter 7, "TurboSTORE/iX 7x24

True-Online Backup," for more information.

The NOTIFY option can be used to help automate the process of performing some action at

the time where the ﬁles being stored are available for modiﬁcation, either at the end of the

STORE, at the end of the attach phase, or at the end of the sync point.

NOTIFY allows STORE to stream a user-speciﬁed job ﬁle (using the MPE/iX STREAM

command) either at the end of the attach phase (while using ONLINE), at the end of a

successful STORE operation (normal backup), or at the end of the sync point (ONLINE=START

or ONLINE=END). The job ﬁle is speciﬁed by the user by setting up a formal ﬁle designator

named NOTIFY, prior to running the store job. This job can contain various actions that

notify users that the ﬁles are free, start other jobs that modify the ﬁles, or allow users back

on to the system, for example.

If the speciﬁed job does not contain passwords, STORE will prompt the user for the

passwords if STORE is being run from a session. If STORE is being run from a job and

passwords are not present, the job stream will fail.

When the job fails to stream, due to lack of passwords, or other reasons, all error messages

will be sent to the standard list ($STDLIST). All other output as the result of streaming

the job will also be sent to $STDLIST.

The following is an example of using the NOTIFY command in conjunction with a user

speciﬁed job ﬁle.

First, set up the ﬁle equation, using the FILE command:

:FILE NOTIFY=MYJOB.PUB.SYS

Where the job stream could contain, for example:

!JOB NOTIFY,MANAGER.SYS

!TELL @ Your files are now available!

!EOJ

Then, run STORE with the NOTIFY option:

:FILE T;DEV=TAPE

:STORE @.PUB.SYS;*T;SHOW;ONLINE;NOTIFY

Since this is an online store, the job stream will be executed once the ﬁles have been

attached, and a message would then be sent to all users telling them that their ﬁles are

now free to be accessed.

Additional Backup Information (STATISTICS)

In addition to the counts of ﬁles stored and not stored that are normally reported at the

end of a backup, the STATISTICS option provides extra data about the backup. This extra

information includes:

• Amount of data written to each piece of media for each parallel set

• Amount of time required to write each piece of media

• Throughput for each piece of media