Identifying SFS files

The system file-name must start with prefix SFS- followed by the SFS server name and file-name. You can specify the system file name if files are located on multiple SFS servers. The following example shows the system file named INVENTORY is located on the SFS server named sfsServer.

export EXTFN=SFS-/.:/cics/sfs/sfsServer/INVENTORY

If you set environment variable CICS_TK_SFS_SERVER to the required SFS server, you can use a shorthand specification for the system file-name instead of using the fully qualified name. The system file-name is prefixed with the value of CICS_TK_SFS_SERVER, followed by a forward slash, to create the fully qualified system file-name. For example:

export CICS_TK_SFS_SERVER=/.:/cics/sfs/sfsServer
export EXTFN=SFS-INVENTORY

The following export command shows a more complex example of how you might set an environment variable MYFILE to identify an indexed SFS file that has two alternate indexes:

export MYFILE="/.:/cics/sfs/sfsServer/mySFSfil(\
/.:/cics/sfs/sfsServer/mySFSfil;myaltfil1,\
/.:/cics/sfs/sfsServer/mySFSfil;myaltfil2)"

The command provides the following information:

• /.:/cics/sfs/sfsServer is the fully qualified name for the CICS server.
• mySFSfil is the base SFS file.
• /.:/cics/sfs/sfsServer/mySFSfil is the fully qualified base system file-name.
• myaltfil1 and myaltfil2 are the alternate index files.

For each alternate index file, the file name must be in the format of its fully qualified base system file-name followed by a semicolon (;) and the alternate index file name: /.:/cics/sfs/sfsServer/mySFSfil;myaltfil1.

A comma is required between specifications of alternate index files in the export command.