Preface

The OpenVOS COBOL Subroutines Manual (R019) documents the operating system subroutines. It explains what each subroutine does and shows how to call each subroutine from an OpenVOS COBOL program.

This manual is intended for systems and application programmers developing applications using the operating system subroutine interface.

Before using this subroutines manual, you should be familiar with the VOS COBOL Language Manual 

This manual does not describe all OpenVOS subroutines. You can search StrataDOC for information about other OpenVOS subroutines. See Getting Help for more information about StrataDOC.

Manual Version

This manual is a revision. For information on which release of the software this manual documents, see the Notice page.

The following subroutine descriptions have been updated to reflect new or modified functionality or to correct mistakes in the previous revision of the manual (with changes marked with change bars).

s$control
s$copy_file
s$create_extent_file
s$expand_star_info
s$get_file_status
s$get_object_status
s$get_open_file_info
s$get_port_attachment
s$get_port_info
s$get_port_status
s$get_port_status_x
s$set_io_time_limit
s$set_no_wait_mode
 

Manual Organization

The manual has three chapters and one appendix.

Chapter 1 gives general information about using the subroutines. You will find the general information you need to use the operating system service subroutines in an OpenVOS COBOL program. The chapter includes a list of the data types of the subroutine arguments, the conventions and rules that govern the declarations of the subroutine parameters, and the method for calling the subroutines from programs written in OpenVOS COBOL.

Chapter 2 classifies all of the subroutines into functional categories and describes the purpose of each subroutine.

Chapter 3 is a reference guide to the subroutines, explaining each subroutine in detail. The subroutines are presented in alphabetical order.

Appendix A contains a table of the OpenVOS internal character code set.

Related Manuals

See the following Stratus manuals for related documentation.

  • Introduction to VOS 
  • VOS Reference Manual 
  • OpenVOS Commands Reference Manual 
  • VOS COBOL Language Manual 
  • OpenVOS COBOL Transaction Processing Facility Reference Manual 
  • VOS Transaction Processing Facility Guide 
  • OpenVOS System Administration: Administering and Customizing a System 
  • OpenVOS System Administration: Registration and Security 
  • OpenVOS System Administration: Disk and Tape Administration 
  • VOS System Administration: Administering the Spooler Facility 
  • OpenVOS System Administration: Configuring a System 
  • Using OpenVOS Extended Names 

Notation Conventions

This manual uses the following notation conventions.

  • Italics introduces or defines new terms. For example:

The master disk is the name of the member disk from which the module was booted.

  • Boldface emphasizes words in text. For example:

Every module must have a copy of the module_start_up.cm file.

  • Monospace represents text that would appear on your terminal's screen (such as commands, subroutines, code fragments, and names of files and directories). For example:
change_current_dir (master_disk)>system>doc
  • Monospace italic represents terms that are to be replaced by literal values. In the following example, the user must replace the monospace-italic term with a literal value.
list_users -module module_name
  • Monospace bold represents user input in examples and figures that contain both user input and system output (which appears in monospace). For example:
display_access_list system_default

%dev#m1>system>acl>system_default

w  *.*

Format for Subroutines

Stratus manuals use the following format conventions for documenting subroutines. Note that the subroutine descriptions do not necessarily include each of the following sections.

subroutine_name
The name of the subroutine is at the top of the first page of the subroutine description.

Purpose
Explains briefly what the subroutine does.

Usage
Shows how to declare the variables passed as arguments to the subroutine, declare the subroutine entry in a program, and call the subroutine.

Arguments
Describes the subroutine arguments.

Explanation
Provides information about how to use the subroutine.

Error Codes
Explains some error codes that the subroutine can return.

Examples
Illustrates uses of the subroutine or provides sample input to and output from the subroutine.

Related Information
Refers you to other subroutines and commands similar to or useful with this subroutine.

Getting Help

If you have a technical question about ftServer system hardware or software, try these online resources first:

  • Online documentation at the StrataDOC Web site. Stratus provides complimentary access to StrataDOC, an online-documentation service that enables you to view, search, download, and print customer documentation. You can access StrataDOC at the following Web site:

http://stratadoc.stratus.com

  • Online support from Stratus Customer Service. You can find the latest technical information about an ftServer system in the Stratus Customer Service Portal at the following Web site:

http://www.stratus.com/go/support

The Service Portal provides access to Knowledge Base articles for all Stratus product lines. You can locate articles by performing a simple or advanced keyword search, viewing recent articles or top FAQs, or browsing a product and category.

To log in to the Service Portal, enter your employee user name and password or, if you have not been provided with a login account, click Register Account. When registering a new account, ensure that you specify an email address from a company that has a service agreement with Stratus.

If you cannot resolve your questions with these online self-help resources, and the ftServer system is covered by a service agreement, contact the Customer Assistance Center. To contact the CAC, use the Service Portal to log a support request. Click Customer Support and Add Issue, and then complete the Create Issue form. A member of our Customer Service team will be glad to assist you.

Commenting on This Manual

You can comment on this manual using one of the following methods. When you submit a comment, be sure to provide the manual's name and part number, a description of the problem, and the location in the manual where the affected text appears.

  • From StrataDOC, click the site feedback link at the bottom of any page. In the pop-up window, answer the questions and click Submit.
  • From any email client, send email to comments@stratus.com.
  • From the Stratus Customer Service Portal, log on to your account and create a new issue.

Stratus welcomes any corrections and suggestions for improving this manual.