02.05.2013 Views

SAS(R) 9.1.3 Companion for z/OS

SAS(R) 9.1.3 Companion for z/OS

SAS(R) 9.1.3 Companion for z/OS

SHOW MORE
SHOW LESS

Create successful ePaper yourself

Turn your PDF publications into a flip-book with our unique Google optimized e-Paper software.

Details<br />

Functions and CALL Routines under z/<strong>OS</strong> FDELETE Function 257<br />

DSNCATLGD returns a value of 1 if the filename is found in the z/<strong>OS</strong> system catalog,<br />

and a value of 0 if the filename is not found in the catalog.<br />

DSNCATLGD is similar to the FILEEXIST function, but there are some differences<br />

that make DSNCATLGD the prefered function to use in some circumstances.<br />

DSNCATLGD does not cause dynamic allocation to occur, which is useful <strong>for</strong> tape data<br />

sets because it does not require that a tape be mounted.<br />

When a batch job is creating a new z/<strong>OS</strong> data set, DSNCATLGD will not return a<br />

value of 1 until the job step that creates the data set terminates. FILEEXIST, which<br />

uses dynamic allocation to verify that the data set exists, returns a value of 1 anytime<br />

after the start of the batch job that is creating the data set.<br />

Note: z/<strong>OS</strong> enters a dynamically allocated data set into the system catalog<br />

immediately at the time of the dynamic allocation request. This includes all allocations<br />

made by TSO users. R<br />

See Also<br />

FCL<strong>OS</strong>E Function<br />

“FILEEXIST Function” on page 259<br />

Closes an external file, a directory, or a directory member<br />

Category: External Files<br />

z/<strong>OS</strong> specifics: file close is strongly recommended<br />

See: FCL<strong>OS</strong>E Function in <strong>SAS</strong> Language Reference: Dictionary<br />

Syntax<br />

FCL<strong>OS</strong>E(file-id)<br />

file-id<br />

specifies the identifier that was assigned when the file was opened, generally by the<br />

FOPEN function.<br />

Details<br />

Files opened with the FOPEN function are not closed automatically after processing.<br />

All files that are opened with FOPEN should be closed with FCL<strong>OS</strong>E. For code<br />

examples, see “FINFO Function” on page 261<br />

See Also<br />

FDELETE Function<br />

3 “FOPEN Function” on page 265<br />

Deletes an external file or an empty directory

Hooray! Your file is uploaded and ready to be published.

Saved successfully!

Ooh no, something went wrong!