From:	SMTP%"RELAY-INFO-VAX@CRVAX.SRI.COM"  3-MAY-1993 08:58:49.41
To:	EVERHART
CC:	
Subj:	Re: Summary: shell$ routines

X-Newsgroups: comp.os.vms
Subject: Re: Summary: shell$ routines
Message-ID: <1993May3.102403.266@kalle.impab.se>
From: glz@kalle.impab.se (Goran Lowkrantz)
Date: 3 May 93 10:02:17 GMT
Organization: IM Program AB, Stockholm, Sweden
Lines: 193
To: Info-VAX@KL.SRI.COM
X-Gateway-Source-Info: USENET

In article <1rn5pp$ftb@lll-winken.llnl.gov>, oberman@ptavv.llnl.gov writes:
> In Article <1993Apr28.191729.9237@dbased.nuo.dec.com>
> lionel@quark.enet.dec.com (Steve Lionel) writes:
> 
>>These routines are actually part of the VAX C RTL, and though they 
>>are listed in Table B-2 (VAX C Run-Time Library Entry Points) in the
>>VAX C Run-Time Library Reference Manual, the VAX C engineers have told me that
>>they consider these routines to be unsupported for customer use and that they
>>are not present in the DEC C RTL.  Use them at your own risk.
> 
> Hate to tell you this, Steve, but I used them (and found a bug in them) on the
> Alpha (V1.0) which is DEC C. Anyone want to check on V1.5?
> 
> R. Kevin Oberman			Lawrence Livermore National Laboratory
> Internet: koberman@llnl.gov		(510) 422-6955
> 
> Disclaimer: Being a know-it-all isn't easy. It's especially tough when you
> don't know that much. But I'll keep trying. (Both)

In the DEC C FT there are the equivalent in a series of decc$* functions.

From the help file:
------------------

C_RTL_FT_HELP

  Run-time_functions

    decc$from_vms

       Converts VMS file specifications to UNIX-style file specifications.

       Syntax:

            #include <unixlib.h>

            int decc$from_vms (char * vms_filespec, int wild_flag, int
            action_routine);



C_RTL_FT_HELP

  Run-time_functions

    decc$match_wild

       Matches a string to a pattern.

       Syntax:

            #include <unixlib.h>

            int decc$match_wild (char *test_string, char *string_pattern);



C_RTL_FT_HELP

  Run-time_functions

    decc$to_vms

       Converts UNIX-style file specifications to VMS file specifications.

       Syntax:

            #include <unixlib.h>

            int decc$to_vms (char *unix-style_filespec, int wild_flag, int
            action_routine);



C_RTL_FT_HELP

  Run-time_functions

    decc$translate_vms

       Translates VMS file specifications to UNIX-style file
       specifications.

       Syntax:

            #include <unixlib.h>

            char *decc$translate_vms (char *vms_filespec);



C_RTL_FT_HELP

  Run-time_functions

    decc$fix_time

       Converts VMS binary system times to UNIX binary times.

       Syntax:

            #include <unixlib.h>

            unsigned int decc$fix_time (int *vms_time);



C_RTL_FT_HELP

  Run-time_functions

    decc$record_read

       Provides additional flexibility in manipulating and observing RMS
       structures on a per-read basis.  This function is inherently
       VMS-specific and should not be used when writing portable
       applications.

       Syntax:

            #include <stdio.h>

            int decc$record_read (FILE *fp, void *buffer,
                                  int nbytes, ...);



C_RTL_FT_HELP

  Run-time_functions

    decc$record_write

       Provides additional flexibility in manipulating and observing RMS
       structures on a per-write basis.

       Syntax:

            #include <stdio.h>

            int decc$record_write (FILE *fp, void *buffer,
                                   int nbytes, ...);



C_RTL_FT_HELP

  Run-time_functions

    decc$set_reentrancy

       Controls the type of reentrancy that reentrant DEC C RTL routines
       will exhibit.

       (See also the /REENTRANCY qualifier.)

       Syntax:

            #include <reentrancy.h>

            int decc$set_reentrancy (int type);

       Use one of the following values for type:

        o  C$C_AST (AST)

           Uses the _BBSSI builtin to perform simple locking around
           critical sections of RTL code, and it may additionally disable
           asynchronous system traps (AST)s in locked regions of code.
           This type of locking should be used when AST code contains
           calls to DEC C RTL I/O routines.

        o  C$C_MULTITHREAD (multithread)

           Designed to be used in conjunction with the DECthreads product.
           It performs DECthreads locking and never disables ASTs.
           DECthreads must be available on your system to use this form of
           reentrancy.

        o  C$C_TOLERANT (tolerant)

           Uses the _BBSSI builtin to perform simple locking around
           critical sections of RTL code, but ASTs are not disabled.  This
           type of locking should be used when ASTs are used and must be
           delivered immediately.  TOLERANT is the default reentrancy
           type.

-- 

  Goran Lowkrantz           Email    : glz@impab.se Tel: Nat    08-6507525
  IM Program AB             CompuServ: 100030,347        Int +46 8 6507525
  Fleminggatan 56                                   Fax: Nat    08-6502870
S-112 45 Stockholm,  Sweden                              Int +46 8 6502870