casfile

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. You can use this option to change the current path of a closed file or, if the file is cataloged, to change the DSNAME from the specified DD NAME.

/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.