casfile

Changes the information held about a file.

Syntax:

casfile [/res-name] [/mprototype:host:WebServiceport] [/fserver-name] [/dfile_DD-name]
[-e{e|u|d}][/iinputscript][/loutput-log]
[/o{o|c}][/pnew-dataset-path]][s{y|n|a}][/t{y|n}]{/w{w|r}]

Parameters:

/res-name

Name of the enterprise server to connect to. Defaults to ESDEMO

Note: When calling this utility from JCL or from a WEB service (that is, when you are running the utility within a SEP) you cannot use the /r option to connect to the server. Where this is the case, you must use the /m or /f options to connect to the server.

or:

/mprototype:host:WebServiceport

Location of the Web Services and J2EE listener for the enterprise server you want to connect to. For example, /mtcp:localhost:9003

or:

/fserver-name

Name of the enterprise server to connect to. This differs from the /r option, in that it performs a lookup to locate the Web Service for the enterprise server

/dfile_DD-name

Name of the file whose information you want to change. This is the eight-byte DD name, identical to the one held in the FCT for the file.

/e{e|u|d}

New file status:

e	Enable; default
u	Unenable
d	Disable

/iinputscript

Name of a file containing the parameters for the file named in file_DD-name or to multiple files

/loutput-log

Name of file to contain the results of executing the command. The default is that the results are displayed on the enterprise server console.

/o{o|c}

New open status:

o	Open; default Note: This sets the status to open, but the file is not physically opened until it is first accessed.
c	Closed

/pnew-dataset-path]

Name of a new path for the file

/s{y|n|a}

Output full file status.

y	On; default
n	Off
a	All files

/t{y|n}

Switch the File Handler trace on or off:

y	On; default
n	Off

/w{w|r}

New write status:

w	Read/write; default
r	Read-only

Note: Options /r, /m, /f are alternative ways of identifying the enterprise server that you want to connect to.

Dependencies:

You must have started the enterprise server before you can issue a casfile command.

Comments:

The /s and /f options are alternatives and are mutually exclusive.

If a path or filename contains spaces, it should be enclosed in quotation marks. For example, "e:\dev mto\files"