The casfile command enables you to change the information held about a file.
Syntax:
casfile {/rserver-name | /mserver-name | /fserver-name} [/dfile-DD-name]
[/e{e|u|d}][/iinput-script][/loutput-log]
[/o{oi|c}][/pnew-dataset-path][/s{y|n|a}][/t{y|n}][/w{w|r}][/uuserid][/apassword][/cgroup]
[/y]
Parameters:
- /rserver-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:
- /mserver-name
- Location of the Web Services and J2EE listener for the enterprise server you want to connect to. Where
server-name takes the form prototype:host:WebServicePort. 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. Where
server-name takes the form prototype:host:port using MFCC.
- /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}
- Sets the file status, where:
-
- e
- Enable; default
- u
- Unenable
- d
- Disable
- /iinput-script
- 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{oi|c}
- Sets the open status, where:
- o
-
Important: -oo has been deprecated. When used, a return code 4 (warning) is received.
Instead of
-oo, use the
-ooi (open immediate) option. If
-oo is used with a region configured for VSAM shareoption use,
-ooi will be forced.
- oi
- Open immediate.
- c
- Closed.
- /pnew-dataset-path
- Name of a new path for the file.
- /s{y|n|a}
- Output full file status, where:
- y
- Display; default
- n
- Suppress
- a
- All files
- /t{y|n}
- Switch the file handler trace on or off for all files, where:
- y
- On; default
- n
- Off
- /w{w|r}
- Set write status, where:
- w
- Read/write; default
- r
- Read-only
- /uuserid
- The user ID authorizing the change.
- /apassword
- The password for the authorizing user ID.
- /cgroup
- The group to be used when running casfile commands.
- If you are using external security with an enterprise server, by default, a user is assigned to their default group at logon.
If the permissions in this group are not sufficient for the casfile operation, use this option to specify another group.
- /y
- For ES.NET CICS regions, this option attempts to ensure all FCT catalog entries defined as remote resources are current.
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.
On UNIX, you can use a dash (-) instead of a forward slash (/).
If a path or filename contains spaces, it should be enclosed in quotation marks. For example,"e:\dev server\files"