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

You also want an ePaper? Increase the reach of your titles

YUMPU automatically turns print PDFs into web optimized ePapers that Google loves.

580 Parse Options Function Appendix 1<br />

Figure A1.4 Initialization FRCB<br />

R1<br />

*<br />

*<br />

*<br />

+0<br />

+4<br />

+8<br />

+12<br />

Parse Options Function<br />

Initialization<br />

function (INITFUNC):0<br />

Pointer to User Exit<br />

BAC Control Block<br />

(INITEXIT)<br />

Pointer to the amount of<br />

storage below the 16M line<br />

(INITBLN)<br />

Pointer to the amount of<br />

storage above the I16M line<br />

(INITMALN)<br />

The user exit can update this field.<br />

UEBCB<br />

Fullword<br />

Fullword<br />

In the Parse Options function, you validate both the name of the user exit and any<br />

INFILE or FILE statement options that <strong>SAS</strong> does not recognize. <strong>SAS</strong> calls this function<br />

once to process the user exit module name. <strong>SAS</strong> then calls the function <strong>for</strong> each<br />

statement option that it does not recognize so that the function can process each option<br />

and value string.<br />

You can use two kinds of statement options in your user exit:<br />

3 options that take a value, such as name=value. For example:<br />

myopt=ABC<br />

Note that quotation marks are considered part of the value; if you want them to<br />

be stripped off, you must provide the code to do so.<br />

3 options that do not take a value.<br />

The first time the Parse Options function is invoked, it should do the following:<br />

3 verify that the virtual storage that was requested during the Initialization<br />

function has been allocated<br />

3 initialize both the allocated virtual storage and the two data areas in the UEBCB<br />

(User Word and Pointer to User Error Message).<br />

The following figure illustrates the Parse Options FRCB structure and its<br />

relationship to other control blocks:

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

Saved successfully!

Ooh no, something went wrong!