Contents SAS/IntrNet 9.1: Application Dispatcher Previous Next

ALLOCATE FILE Statement


Defines a file that the Application Server assigns


Syntax

ALLOCATE FILE fileref <device-type> 'directory-or-PDS-path' <host-options>;

Note: The syntax of the ALLOCATE FILE statement is identical to that of the global FILENAME statement. The above syntax is simplified. For a complete listing of arguments and explanations, see the FILENAME statement in SAS Language Reference: Dictionary.


Arguments

fileref
associates a SAS fileref with an external file or directory. You can use any SAS name when you are assigning a new fileref. You can list SAS filerefs that are defined in the ALLOCATE FILE statement in a DATALIBS, PROGLIBS, or ADMINLIBS statement. SAS filerefs that are listed in a DATALIBS statement are available to all programs that are run by the Application Server.

Note: SAS filerefs that are defined outside PROC APPSRV by using FILENAME statements are not accessible by Application Server programs and cannot be listed in a DATALIBS, PROGLIBS, or ADMINLIBS statement.

device-type
specifies the type of device. Values include

DISK
specifies that the device is a disk drive. When assigning a fileref to a file on a disk, you are not required to specify DISK.

TAPE
specifies a tape drive.

DUMMY
specifies a bit bucket or null device.

directory-or-PDS-path
specifies a directory or partitioned data set (PDS) that is the pathname for a SAS fileref that is used in a PROGLIBS or ADMINLIBS statement. A directory is assumed to contain SAS source code in individual .sas flat files. A PDS is assumed to contain SAS source code in individual members. You must enter the directory or path in one of the following forms, depending on which operating environment the SAS server is using:

Operating Environment Example Directory or Path
UNIX /u/jdoe/samples
Windows C:\samples
z/OS (HFS directory) /u/jdoe/samples
z/OS (PDS) SAS.INTRNET.SAMPLES

host-options
indicates host- and device-specific details, such as file attributes and processing attributes. For details about host and device options, see SAS Language Reference: Dictionary and the SAS documentation for your operating environment.

Contents SAS/IntrNet 9.1: Application Dispatcher Previous Next