SET Modify File Attributes (Cache/SMS)

ONXSET CCS=[name | *NONE]

The specified Coded Character Set will be assigned for the files or PLAM library elements.

*NONE: The link to a Coded Character Set will be deleted.

ONXSET param=val

One of the Caching (Hiperfile) or SMS (System Managed Storage) file attributes will be set or modified. Only one keyword and its respective value can be specified at a time.

ADMINFO='info' | NO

'info' For each file the system administrator can store a one to eight byte info string for Administration Information purposes in the system catalog (from OSD V3.0).

NO No Administration Information will be stored for the file. Existing information will be deleted.

AVAIL=HIGH | STD

HIGH High Availability. The file will be designated as High Availability, meaning that BS2000 will automatically store the file on media such as mirrored volumes. If no such volume exists, the operation will be aborted with an error message.

STD No particular action will be taken regarding the availability of the data.

DELDATE=dd.mm.yyyy | nnn | NONE

dd.mm.yyyy Deletion date for the file. The file may be deleted as from this date, without reference to the protection attributes set by the owner (as from OSD V3.0).

nnn one to digit value representing the number of days from the current date after which the file may be deleted.

NONE No deletion date is set. Any file protection attributes set by the owner will be taken into account.

DISKWR=IMMEDIATE | BY-CLOSE

IMMEDIATE The file may not be processed in conjunction with a write cache, i.e. the file data must be rendered consistent immediately following every write operation.

BY-CLOSE The file data only needs to be made consistent following the file close operation.

IOPERF=HIGH | VERY-HIGH | STD | USER-MAXIMUM

HIGH The file should be processed in conjunction with a cache (High Performance priority)

VERY-HIGH The file should be processed in conjunction with a cache. If possible, the entire file should be held permanently in the cache.

STD The file possesses no particular Performance attribute, and will not be processed in conjunction with a cache.

USER-MAX The file will be assigned the highest possible Performance attribute allowed by the entry for the user in the Join file.

IOUSAGE=READ-WRITE | READ | WRITE

READ-WRITE A raised Performance attribute is required for read and write operations.

READ A raised Performance attribute is only required for read operations on the file.

WRITE A raised Performance attribute is only required for write operations on the file.

MANCLASS=class | NONE

class Specifies an HSMS-defined Management Class via which the file security, archiving and migration can be controlled. Specifying a Management Class for files on SM pubsets is possible from OSD V3.0.

NONE An existing Management Class definition is reset. Data security is controlled by the standard values or by the characteristics defined with an MA/MI Action Code.

S0MIGR=ALLOWED | FORBIDDEN

ALLOWED The file can be stored within the S0 level to another Volume set on the same SM pubset. The storage can be achieved implicitly through HSMS or implicitly through BS2000. This is possible from OSD V3.0.

FORBIDDEN The file may not be stored within an SM pubset. This is restricted to the system administrator.

STOCLASS=class | STD | NONE | UPDATE

class The file on the SM pubset will be allocated to the specified Storage class. The names and characteristics of the Storage classes are defined by the system administrator and can be queried by the /SHOW-STORAGE-CLASS BS2000 command. Storage classes allow simple rules to be defined for the storage locations for files within an SM pubset. Allocating a Storage class to a file enables it to be migrated implicitly from one Volume set to another within an SM pubset.

Allocating a Storage class is possible from OSD V3.0.

STD The default Storage class associated with the SM pubset user entry will be allocated. If no default Storage class has been defined then the file will have the same attributes as for STOCLASS=NONE.

NONE The file will not be allocated a Storage class. The storage location for the file will be determined by the following characteristics (see the respective parameters of the MODIFY-FILE-ATTR command): WORK-FILE, VOLUME-SET, VOLUME, DEVICE-TYPE, IO-ATTRIBUTES, FILE-PREFORMAT, DISK-WRITE, AVAILABILITY.

UPDATE If the file has already been assigned a Storage class, the current value will be read from the Storage class catalog and applied to the file. This option is relevant if the attributes have been amended since the last time it was referenced by the file.

USERINFO='info' | NO

'info' The user can associate a one to eight byte information element info with the file (from OSD V3.0).

NO No user information will be associated with the file. An existing entry will be deleted.

WORK=YES | NO | STD

YES The file on the SM pubset will be cataloged as a work file in the system catalog, and hence can be deleted at some later point by the system (from OSD V3.0).

NO The file is not cataloged as a work file.

STD The file will only be cataloged as a work file if it is already stored on a Volume set designated for work files.