Open System Services Porting Guide (G06.24+, H06.03+)
Table Of Contents
- What’s New in This Manual
- About This Manual
- 1 Introduction to Porting
- 2 The Development Environment
- 3 Useful Porting Tools
- 4 Interoperating Between User Environments
- Purpose of Interoperability
- The OSS User Environment
- OSS Commands for the Guardian User
- Guardian Commands for the UNIX User
- OSS Pathname and Guardian Filename Conversions
- Running the OSS Shell and Commands From TACL
- Running Guardian Commands From the OSS Shell
- Running OSS Processes With Guardian Attributes
- Using OSS Commands to Manage Guardian Objects
- 5 Interoperating Between Programming Environments
- 6 OSS Porting Considerations
- 7 Porting UNIX Applications to the OSS Environment
- 8 Migrating Guardian Applications to the OSS Environment
- General Migration Guidelines
- C Compiler Issues for Guardian Programs
- Using New and Extended Guardian Procedures
- Using OSS Functions in a Guardian Program
- Interoperating With OSS Programs
- Starting an OSS Program From the Guardian Environment
- C Compiler Considerations for OSS Programs
- Porting a Guardian Program to the OSS Environment
- How Arguments Are Passed to the C or C++ Program
- Differences in the Two Run-Time Environments
- Which Run-Time Routines Are Available
- Use of Common Run-Time Environment (CRE) Functions
- Replacing Guardian Procedure Calls With Equivalent OSS Functions
- Which IPC Mechanisms Can Be Used
- Interactions Between Guardian and OSS Functions
- 9 Porting From Specific UNIX Systems
- 10 Native Migration Overview
- 11 Porting or Migrating Sockets Applications
- 12 Porting Threaded Applications
- A Equivalent OSS and UNIX Commands for Guardian Users
- B Equivalent Guardian Commands for OSS and UNIX Users
- C Equivalent Inspect Debugging Commands for dbx Commands
- D Equivalent Native Inspect Debugging Commands for dbx Commands
- E Standard POSIX Threads Functions: Differences Between the Previous and Current Standards
- Glossary
- Index
Open System Services Porting Guide—520573-006
4-1
4
Interoperating Between User
Environments
The Open System Services (OSS) shell and utilities provide you with the ability to
manipulate Guardian objects such as files and processes. Several commands and
utilities have been implemented to enhance the interoperability between the OSS and
Guardian environments.
For porting and developing OSS application programs for the OSS environment, you
need to work with both OSS and Guardian files and processes, with the OSS
command interface using the OSS utilities and the Guardian command interface called
HP Tandem Advanced Command Language (TACL).
This section has multiple purposes. It provides information for programmers and other
users who need to interact in both the OSS and Guardian environments. This section
is intended for the user of the OSS shell who needs to access processes and files that
reside in the Guardian environment. It is also intended for the TACL user who needs to
access processes and files that reside in the OSS environment. The user should have
a basic understanding of the UNIX Bourne, C, or Korn shell.
This section includes information about the TACL command interface and the OSS
utilities to access and manipulate OSS and Guardian files and processes that you
encounter as part of your porting or developing tasks. For detailed information on the
OSS shell and utilities and OSS operations tasks for the user, refer to the OSS utility
online reference pages, to the Open System Services Shell and Utilities Reference
Manual, or to the Open System Services User’s Guide.
The following topics are discussed in this section:
•
Purpose of Interoperability on page 4-1
•
The OSS User Environment on page 4-4
•
OSS Commands for the Guardian User on page 4-10
•
Guardian Commands for the UNIX User on page 4-14
•
OSS Pathname and Guardian Filename Conversions on page 4-18
•
Running the OSS Shell and Commands From TACL on page 4-19
•
Running Guardian Commands From the OSS Shell on page 4-21
•
Running OSS Processes With Guardian Attributes on page 4-22
•
Using OSS Commands to Manage Guardian Objects on page 4-23
Purpose of Interoperability
With the coexistence of the OSS environment and the Guardian environment under a
single operating system (the NonStop operating system), interoperability becomes an
important requirement. HP defines interoperability as providing: