18.08.2013 Views

(SYSLIB) Programming Reference Manual - Public Support Login ...

(SYSLIB) Programming Reference Manual - Public Support Login ...

(SYSLIB) Programming Reference Manual - Public Support Login ...

SHOW MORE
SHOW LESS

Create successful ePaper yourself

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

SFDT$–System Standard Format Date and Time<br />

Recommended Date and Time Formats<br />

Since there are many possible date and time format combinations, the following formats<br />

are recommended as standard:<br />

YYMMDD HHMM:SS format (1,2) –most compact<br />

CCYY-MM-DD HHMM:SS format (4,2)<br />

CCYY mmm ddd HHMM:SS format (8,2) –most descriptive<br />

The element SFDTBL$ contains the ASCII character abbreviations for months and days.<br />

It is accessed by external label SFDTBL$. These abbreviations may be changed to other<br />

abbreviations for months and days, for example, when using languages other than<br />

English.<br />

SFDT$ can be called from both MASM and PLUS routines. It is available as a relocatable<br />

element in the <strong>SYSLIB</strong> file (SYS$LIB$*<strong>SYSLIB</strong>) or SYS$*RLIB$ and in the <strong>SYSLIB</strong><br />

common bank <strong>SYSLIB</strong>$1. The relocatable and common bank entry points to SFDT$ are<br />

listed in Appendix E.<br />

22.1. MASM Interface<br />

SFDT$ can be called directly from MASM programs. The packet for SFDT$ is described<br />

in 22.1.1. The calling sequence for SFDT$ is described in 22.1.2.<br />

22.1.1. Packet<br />

The calling program must provide a five-word packet for SFDT$. The following MASM<br />

PROC generates this packet:<br />

label S$FDTPKT datefmt,timefmt,buflen,bufaddr[,sep][,offset]<br />

The packet is shown in Figure 22–1.<br />

0 tscell datefmt timefmt sep reserved version<br />

01 offset numchar buflen errcode<br />

02 bufaddr<br />

03 date<br />

04 time<br />

Figure 22–1. SFDT$: Packet Format<br />

7833 1733–004 22–3

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

Saved successfully!

Ooh no, something went wrong!