Compaq ACMS for OpenVMS
Quick Reference Guide


Previous Contents Index

4.4.2 ACMS$CONNECT_STREAM

Establishes a connection to a stream and returns a connect ID. Before using this service, you have to create a stream with ACMS$CREATE_STREAM.
ACMS$CONNECT_STREAM (stream.id.rq.r,
mode.rl.r,
connect.id.wq.r,
[submitter.id.rq.r])
ACMS$CONNECT_STREAM_A (stream.id.rq.r,
mode.rl.r,
connect.id.wq.r,
[comp_status.wq.r],
[efn.rbu.r],
[astadr.szem.r],
[astprm.rz.v],
[submitter_id.rq.r])

4.4.3 ACMS$CREATE_STREAM

Creates a stream and returns the stream identification.
ACMS$CREATE_STREAM (mode.rl.r,
stream_id.wq.r)
ACMS$CREATE_STREAM_A (mode.rl.r,
stream _id.wq.r,
[comp_status.wq.r],
[efn.rbu.r],
[astadr.szem.r],
[astprm.rz.v])

4.4.4 ACMS$DELETE_STREAM

Deletes a stream. Use this service after ACMS$DISCONNECT_STREAM disconnects all connect IDs to the stream. Once deleted, a stream is not available for use by other tasks.
ACMS$DELETE_STREAM (stream_id.rq.r,
[flags.rl.r])
ACMS$DELETE_STREAM_A (stream_id.rq.r,
[flags.rl.r],
[comp_status.wq.r],
[efn.rbu.r],
[astadr.szem.r],
[astprm.rz.v])

4.4.5 ACMS$DISCONNECT_STREAM

Breaks a connection to a stream. The application execution controller (EXC) must disconnect from the stream before the agent can disconnect.
ACMS$DISCONNECT_STREAM (connect_id.rq.r,
[flags.rl.r])
ACMS$DISCONNECT_STREAM_A (connect_id.rq.r,
[flags.rl.r],
[comp_status.wq.r],
[efn.rbu.r],
[astadr.szem.r],
[astprm.rz.v])

4.4.6 ACMS$OPEN_RR

For tasks that use TDMS, the agent calls ACMS$OPEN_RR to open a TDMS channel to a terminal and associates it with a submitter ID. Subsequent task selections for that submitter use the channel for all task request I/O, including remote request I/O. For tasks that use the ACMS Request Interface (RI), the agent calls ACMS$OPEN_RR to prepare the agent process to do the I/O.
ACMS$OPEN_RR (device.rt.dx,
channel.wlu.r,
[submitter_id.rq.r],
[flags.rl.r],
[nullarg])
ACMS$OPEN_RR_A (device.rt.dx,
channel.wlu.r,
[submitter_id.rq.r],
[flags.rl.r],
[nullarg],
[comp_status.wq.r],
[efn.rbu.r],
[astadr.szem.r],
[astprm.rz.v])


Appendix A
Checklist for ACMS Application Development

Figure A-1 illustrates the phases of application development for ACMS, from the initial design of an application to the actual production of the application. Figure A-1 is followed by a more detailed checklist of the phases of application development you can use with the figure.

Figure A-1 ACMS Application Design, Development, and Use


  1. Design application
  2. Set up data
    RMS:
    DBMS:
    Rdb:
  3. Define tasks
  4. Create workspaces
  5. Create DECforms forms
  6. Create TDMS forms
  7. Create TDMS requests
  8. Write procedures
  9. Create message files
  10. Create task groups
  11. Create the procedure server image
  12. Debug
  13. Set up the application
  14. Move the application database to ACMS$DIRECTORY
  15. Set up menus
  16. Test the application
  17. Authorize users
  18. Authorize terminals
  19. Manage and tune the application


Appendix B
Changing and Debugging ACMS Applications

Application development is a cyclical process. Omissions or problems in the analysis or design might not show up until implementation is complete. To correct these omissions or problems, you might need to redo part of the design and implementation. For this reason, it is helpful to understand what parts of an application have to change if you change some other part.

Table B-1 summarizes these relationships between different parts of ACMS applications.

Table B-1 Changing ACMS Applications
Changed Component Changes to Related Components When Change Takes Effect
Menu database name (.MDB) User definitions (in ACMSUDF.DAT file) pointing to menu database must be changed. Next time user signs in to ACMS.
  Menu definitions should be changed if they include a clause naming database file. When user signs in after menu database is rebuilt.
Menu definition Menu database containing that definition must be rebuilt. New database must be put in directory pointed to by ACMSUDF.DAT records (usually ACMS$DIRECTORY). When user signs in after menu database is rebuilt.
Application database name (.ADB) Menu definitions pointing to tasks in that application must be changed and menu database rebuilt. When user signs in after menu database is rebuilt.
  Application authorization definitions must be modified to reflect new application name. When application database is reinstalled with ACMS/INSTALL command.
Application definition Application database must be rebuilt. Menu definition database does not need to be changed unless name of task is changed in application definition. When application is stopped and restarted.
  If changes to application definition conflict with existing authorization for application in ACMSAAF.DAT, authorization must be modified and application database reinstalled with ACMS/INSTALL command. When application is moved to ACMS$DIRECTORY with ACMS/INSTALL command.
Task group database name (.TDB) Application definition must be changed and rebuilt. Task group definition should be changed and rebuilt if it points to task group database file. When application is stopped and restarted.
Task group
definition
Task group database must be rebuilt. When application is stopped and restarted.
  If a task was added or removed, the application database must be rebuilt, even if no change is required in application definition.  
  If a task is removed or a task name changed, menu definition pointing to task must be changed. In addition, the menu database and application database must be rebuilt. If the task removed from the task group was also named in application definition, application definition must be changed and rebuilt.  
  If default control attributes of a task are changed, and these attributes are not overridden in application definition, application database must be rebuilt.  
  If changes to task group definition conflict with existing authorization for application in ACMSAAF.DAT, authorization must be modified and application database reinstalled with ACMS/INSTALL command. When application is moved to ACMS$DIRECTORY with ACMS/INSTALL command.
Task definition Task group database must be rebuilt. When application is stopped and restarted.
  If default control attributes of task are changed, and these attributes are not overridden in application definition, application database must be rebuilt.  
  If task name is changed, task group definition must be changed to reflect new name.  
Request Request library (.RLB) must be rebuilt. When application is stopped and restarted.
  If number of records or if record definitions used by request are changed, task group database must be rebuilt.  
  If request name is changed, task definition must be changed.  
  If request library name is changed, task group definition must be changed.  
Form definition Request library (.RLB) must be rebuilt. When application is stopped and restarted.
  If form name is changed, request definition must be changed.  
Form panel FORM file must be back-translated to produce a source IFDL file. Object module must be extracted and relinked with or without escape units. When application is stopped and restarted.
Form record IFDL file must be translated to produce a new FORM file. Object module must be extracted and relinked with or without escape units. When application is stopped and restarted.
Step procedure Step procedure must be recompiled and server image (.EXE) relinked When application is stopped and restarted, or when server is replaced.
  If number of workspaces or if record definitions that the procedure uses for workspaces are changed, task must be redefined and task group database rebuilt.  
  If procedure name is changed, procedure server definition in task group must be changed. Task definition must be changed.  
Message source file File of message texts (.EXE) must be relinked. When server using message is restarted after relink.
  If message was added or removed or order of messages changed, new message object module must be generated. Server image must be relinked with the new module. Stop and restart application to ensure that changes are available.
Workspace
definition
If task definition, form record, request, or procedure refers to fields that have changed name, definition or program must be changed. Task group database or request library must be rebuilt, or procedure relinked. When application is stopped and restarted after rebuild.
  Both task group and form file or request library must also be rebuilt and program relinked if order of fields in workspace or other characteristics have changed, even if requests, task definitions, and procedures are not affected by change.  
  If name of workspace definition is changed, procedure, task definition, and form record or request must also be changed. Task group and request library must be rebuilt. Procedure must be recompiled and relinked.  
Application authorization (with AAU) If using ACMS/INSTALL command, reinstall application database. When application database is moved into ACMS$DIRECTORY with ACMS/INSTALL command.
  If changes to authorization place further restrictions on application, remove old application from ACMS$DIRECTORY and reinstall application database.  
User or device authorization (with UDU or DDU) If change does not affect access control lists or menu names, no other change is required. Next time user signs in to ACMS.
  If change affects access control lists in application definition, application must be redefined and rebuilt.  
  If change affects names of menus, menus must be redefined and rebuilt.  
  If change affects which terminals are controlled by ACMS, no other change is required. After ACMS/RESET TERMINALS command is issued, or after ACMS is stopped and restarted.

Table B-2 describes the files needed to run a task with the ACMS Task Debugger.

Table B-2 Files Used to Debug ACMS Tasks
File Description
Data files or database files for task group Created and populated using either RMS, DBMS, or Rdb.
Message file or files for task group Created with the OpenVMS Message Utility. This file contains text of messages and their message symbols. You need this file only if your tasks use the GET MESSAGE clause to access a message file that is separate from the server image.
Procedure Server Images Created with the LINK command. Contains executable versions of the procedure server transfer module, message file module, and all procedures for the task group.
DECforms form files Created using DECforms.
Task database --- TDB Created with the BUILD command of the ACMS Application Definition Utility --- ADU. Contains information used by ACMS to run tasks. Include the /DEBUG qualifier with the BUILD command to examine and deposit data in the workspace while debugging the task.

Table B-3 describes the sources used to create the files used for debugging ACMS tasks.

Table B-3 Source Files for Debugging
File Description
ADU input files Contain source definitions for task groups and tasks.
CDO input files Contain CDD source definitions for ACMS workspace records.
RDU input files Contain source definitions for requests and request libraries.
Step, initialization, termination, and cancel procedures Written in COBOL, BASIC, or other high-level languages.
Message source files Contain source text for messages.
Procedure server transfer
module
Created by building the task group. Contains vectors for the procedures handled by the server and the main entry point for the procedure server image.


Previous Next Contents Index