SG/6.3

Starlink Project
Starlink Guide 6.3

R.F. Warren-Smith

4th February 1994


ADAM
Programmer’s
Facilities & Documentation
Guide



Abstract

This document contains a directory of the facilities available to the ADAM programmer. All documented aspects of ADAM programming are covered, ranging from introductory documentation, through applications programming to real-time and system programming. Each facility is briefly described along with the type of work for which it might be used. Most importantly, this guide shows at a glance where to obtain the relevant documentation.

It is hoped to update this document relatively frequently, so that it serves as a guide to the latest ADAM developments. Its format, which includes an overall index, is designed to allow its use as a table of contents for a personal file of programming documentation.

Contents

1 Introductory Documentation
2 General Applications Programming
3 More-specialised Facilities
4 Lower-level Facilities
5 Programming Tools
6 Instrumentation Programming
7 System Programming
8 Standards and Conventions

Documentation Index

1 Introductory Documentation

1-1

INTRO

Introduction to ADAM Programming

SUN/101

1-2

ADAM

The Starlink Software Environment

SG/4

2 General Applications Programming

2-1

PAR

ADAM Parameter System Routines

SUN/114

2-2

NDF

Extensible N-Dimensional Data Format

SUN/33

2-3

MSG & ERR

Message and Error Reporting

SUN/104

2-4

CHR

Character Handling

SUN/40

2-5

PGPLOT

Graphics Library

SUN/15

2-6

SGS

Simple Graphics System

SUN/85

2-7

FIO & RIO

File Input/Output

SUN/143

2-8

MAG

Magnetic Tape Handling

SUN/171

2-9

PRIMDAT

Primitive Numerical Data Processing

SUN/39

2-10

ICL

ADAM Command Language

SG/5

2-11

IFL

ADAM Interface Module Reference Manual

SUN/115

3 More-specialised Facilities

3-1

SLALIB

Positional Astronomy and Time

SUN/67

3-2

NCAR

Graphics Utilities

SUN/88

3-3

SNX

Starlink Extensions to NCAR

SUN/90

3-4

AGI

Applications Graphics Interface

SUN/48

3-5

PSX

POSIX Interface Routines

SUN/121

3-6

REF

References to HDS Objects

SUN/31

3-7

TRANSFORM

Coordinate Transformation Facility

SUN/61

3-8

HELP

Help Text Retrieval System

SUN/124

4 Lower-level Facilities

4-1

ARY

Access to ARRAY Data Structures

SUN/11

4-2

HDS

Hierarchical Data System

SUN/92

4-3

IDI

Image Display Interface

SUN/65

4-4

GKS

Graphical Kernel System

SUN/83

4-52

GRP

Routines for Managing Groups of Objects

SUN/150

4-6

GWM

X Graphics Window Manager

SUN/130

4-7

GNS

Graphics Workstation Name Service

SUN/57

5 Programming Tools

5-1

STARLSE

Starlink Language Sensitive Editor

SUN/105

5-2

SST

Simple Software Tools

SUN/110

5-3

GENERIC

Utility for Compiling Generic Fortran

SUN/7

6 Instrumentation Programming

6-1

TASK

Guide to Writing ADAM Instrumentation Tasks

SUN/134

6-2

NBS

Noticeboard System

SUN/77

6-3

MSP

Message System Primitive Routines

SSN/2

7 System Programming

7-1

EMS

Error Message Service

SSN/4

7-2

CNF & F77

Mixed Language Programming

SGP/5

8 Standards and Conventions

8-1

FORTRAN

Application Programming Standard

SGP/16

8-2

C

Starlink C Programming Standard

SGP/4

8-3

DATA

Starlink Standard Data Structures

SGP/38

8-4

PACKAGES

Organisation of ADAM Applications Packages

SSN/64

8-5

LIBRARIES

Conventions for Accessing Starlink Libraries

SSN/8

8-6

UNIX

Starlink Software Organisation on UNIX

SSN/66

1The documentation for these facilities has changed since the previous version of this guide (dated 7th August 1992). Please ensure that you have a copy of the most recent documents.

2New facility.