Rockwell Automation 9323-PA2E User Manual

Preface P-1.............................................................................................
Who Should Use this Manual P-2...........................................................................
Purpose of this Manual P-2....................................................................................
Terms and Abbreviations P-4.................................................................................
Common T echniques Used in this Manual P-4.....................................................
Introducing the APS Import/Export Utility 1-1....................................
APSIE Overview 1-2..............................................................................................
System Requirements 1-2......................................................................................
Running the Software 1-3......................................................................................
APSIE Menu Display 1-4........................................................................................
Starting the Utility 1-6.............................................................................................
Configuring the APS Import/Export Software 2-1.............................
Configuring the System 2-2....................................................................................
Specifying the User Directories 2-4........................................................................
Importing ASCII Documentation/ Archive Files 3-1...........................
Configuring the Import Utility 3-2............................................................................
Selecting Import Options 3-4..................................................................................
Importing ASCII Files 3-6.......................................................................................
Examining the Results of the Import 3-8................................................................
Exporting APS Documentation/ Archive Files 4-1.............................
Configuring the Export Utility 4-2............................................................................
Selecting Export Options 4-4.................................................................................
Selecting Export Address Types 4-7......................................................................
Exporting APS Files 4-9.........................................................................................
Examining the Results of the Export 4-10................................................................
Creating an ASCII Archive File 5-1......................................................
Explaining Keywords, Operands, and Comments 5-2............................................
Specifying ASCII Archive Files 5-5.........................................................................
Protecting Archive Files (SLC 5/03 and SLC 5/04 Processors Only) 5-36..............
Examining ASCII Archive Files 5-38........................................................................
Creating an ASCII Documentation File 6-1........................................
Creating an ASCII Documentation File 6-2............................................................
Example ASCII Documentation File 6-8.................................................................
Programming Instruction References A-1..........................................
Valid Addressing Modes and File Types A-2..........................................................

Preface

Preface
Read this preface to familiarize yourself with the rest of the manual. This preface covers the following topics:
who should use this manual
the purpose of this manual
terms and abbreviations used
conventions used in this manual
P-1
APS Import/Export Utility User Manual
Preface

Who Should Use this Manual

Use this manual if you are responsible for designing, installing, programming, or troubleshooting control systems that use Allen-Bradley small logic controllers.
You should have a basic understanding of SLC 500t products. If you do not, contact your local Allen-Bradley representative for the proper training before using this product.
We recommend reviewing the software.

Purpose of this Manual

This manual is a reference guide for the APS Import/Export utility procedures you use to convert APS archive files and program documentation into ASCII text files, and vice versa.
Contents of this Manual
Chapter Title Contents
Preface
1
2
3
4
5
6
Appendix A
Introducing the APS Import/Export Utility
Configuring the APS Import/Export Utility
Importing ASCII Documentation/Archive Files
Exporting APS Documentation/Archive Files
Creating an ASCII Archive File
Creating an ASCII Documentation File
Programming Instruction References
APS Quick Start for New Users
Describes the purpose, background, and scope of this manual. Also specifies the audience for whom this manual is intended.
Introduces you to the APS Import/Export utility and shows you how to start it.
Guides you through the configuration of the APS Import/Export utility.
Guides you through the configuration of the import utility and then the import operation.
Guides you through the configuration of the export utility and then the export operation.
Explains how to build an ASCII archive file, then provides examples.
Explains how to build an ASCII documentation file, then provides an example.
Provides you with valid addressing modes and file types.
before using the
. It describes the
P-2
Related Documentation
The following documents contain additional information concerning RSI and Allen-Bradley SLC products. To obtain a copy
distributor.
For Read this Document
An introduction to APS for firsttime users, containing basic concepts but focusing on simple tasks and exercises, and allowing the reader to begin programming in the shortest time possible
A training and quick reference guide to APS
A guide of common procedures used in APS
A procedural manual for technical personnel who use APS to develop control applications
A reference manual that contains status file data and instruction set information for the SLC 500 processors and MicroLogix 1000 controllers.
Preface
, contact your local sales of
APS Quick Start for New Users
SLC 500 Software Programmer's Quick Reference Guide, Publication Number
ABT1747TSG001available on PASSPORT
at a list price of $50.00
SLC 500 Software Common Procedures Guide, Publication Number
ABT1747TSJ50available on PASSPORT
at a list price of $50.00
Advanced Programming Software (APS) User Manual
Instruction Set Reference Manual
fice or
An overview of the SLC 500 family of products
A description on how to install and use your Fixed SLC 500 programmable controller
A description on how to install and use your Modular SLC 500 programmable controller
A complete listing of current documentation, including ordering instructions. Also indicates whether the documents are available on CDROM or in multilanguages.
A glossary of industrial automation terms and abbreviations
SLC 500 System Overview, Publication Number 17472.30
Installation and Operation Manual for Fixed Hardware Style Programmable Controllers, Catalog Number 1747NM001
Installation and Operation Manual for Modular Hardware Style Programmable Controllers, Publication Number 17476.2
AllenBradley Publication Index, Publication Number SD499
AllenBradley Industrial Automation Glossary, Publication Number AG7.1
P-3
APS Import/Export Utility User Manual
Preface

Terms and Abbreviations

The following terms and abbreviations are specific to this product. For a complete listing of Allen-Bradley terminology, refer to the Allen-Bradley Industrial Automation Glossary
Archive File a file, stored on a disk and in binary format, that contains an SLC 500 processor program.
Documentation File  a file, stored on a disk and in binary format, that contains rung, instruction, address comments and symbols.
APS  Advanced Programming Software.
, publication number AG–7.1.
APSIE
ASCII
RSI
SLC
APS Import/Export utility.
a group of alphanumeric characters that defines a line in an import file.
Rockwell Software, Inc.
small logic controller

Common Techniques Used in this Manual

The following conventions are used throughout this manual:
Bulleted lists such as this one provide information, not procedural steps.
Numbered lists provide sequential steps or hierarchical information.
Italic
Text in this font
type is used for emphasis.
indicates words or phrases you should type.
Key names match the names shown and appear in bold, capital letters within brackets (for example, [ENTER]). A function key icon matches the name of the
CONFIG
OFFLINE
function key you should press, such as
SAVE &
EXIT
CONFIG
F8
.
P-4
Introducing the
APS Import/Export Utility
1
Introducing the APS Import/Export Utility
This chapter provides:
an overview of the APSIE utility
the system requirements
the APSIE display format
the APSIE menu display
This chapter also shows you how to:
run the software
start the utility
1-1
APS Import/Export Utility User Manual
Preface

APSIE Overview

The APS import/export utility, APSIE, lets you convert:
APS archive files and program documentation into ASCII text files
ASCII text files that contain an SLC 500 program and program documentation
into APS archive files
You install APSIE as you install APS, although it executes separately from APS. APSIE interacts with archive and documentation files generated by all versions of APS.
Another key feature of APSIE is its you specify the drives and directories that APSIE reads files from and writes files to. With this capability you can have files in any MS–DOS directory. For more information on user directories, see chapter 2, Configuring the APS Import/Export Utility.

System Requirements

You can use APSIE with an Allen-Bradley T47 or T70 terminal, 386/SX, NEC VERSAtE Series Notebook, or GATEWAY 2000t models 386DX/25, 386DX/33, 486DX/33, 486DX2/50, and 486DX2/66 personal computers. Your computer must have:
640 Kbytes of RAM
10 Mbyte fixed-disk drive (APS requires 8.5 Mbytes of free disk space.)
DOS version 3.3 or higher
The maximum number of archive, documentation, and ASCII files allowed by APSIE is limited solely by the available space on your floppy or fixed disk.
Define Dir
ectory
function. This function lets
1-2

Running the Software

To run the APSIE software, follow these steps:
Introducing the
APS Import/Export Utility
If necessary
1.
, change the drive specifier to the drive where the software is
installed (typically C). To do this, type:
and press
C:
[ENTER].
2. If you are using the default directory, at the DOS prompt, type:
CD \IPDS\ATTACH\SLC500
and press
[ENTER].
If you specified a different directory path, change to that directory and press [ENTER].
3. Type: APSIE
and press
[ENTER]. The import/export utility displays the
main screen.
SLC–500 APS IMPORT/EXPORT UTILITY
Rockwell Software Incorporated, Copyright 1989–1995
This software is licensed to: Your Name
Mon July 18, 1994
9323 – PA2E
All Rights Reserved
Your Company 0000000000
11:03:09 am
Press a function key
4. Become familiar with the APSIE display format and menu on pages 1-4
1-5. Then, go to the next section, Starting the Utility, to perform a task from the main menu.
and
1-3
APS Import/Export Utility User Manual
Preface

APSIE Display Format

The APSIE screen is divided into three areas:
display area
message, prompt, data entry and status lines
APSIE menu functions
The screen below indicates what appears in these areas.
Display area
SLC-500 APS IMPORT/EXPORT UTILITY
Rockwell Software Incorporated, Copyright 1989–1995
This software
Display area: V
are performing.
9323 – PA2E
All Rights Reserved
Message line:
operation appear here.
arious windows overlay the display depending on the function you
Error codes/descriptions and information concerning terminal
Mon July 18, 1994
. . . Working . . .
F1 F2 F3
Data/Cmd entry:
Menu
Functions:
Message:
Prompt:
Status:

APSIE Menu Display

From the APSIE main menu there are three tasks that you can start. You can import ASCII files, export APS files, or configure the utility running APSIE, various windows are displayed depending on the function you are accessing. The function keys also change as the windows change. See table 1.A.
1-4
Prompt line:
Indicates action you should take.
Data/Cmd entry line:
Status line:
Menu functions:
function keys F1 to F10. Pressing a main function key calls up subfunctions or
SELECT OPTIONS
option windows.
F5 F7 F8 F9
Information entered from the keyboard appears on this line.
Status information concerning the program files appears on this line.
APSIE functions appear here. They are accessed by menu
EXPORT
ACH&DOC
EXPORT
ACH
EXPORT
DOC
. As you press keys while
Table 1.A Function Keys — APSIE Menu Display
Press this
main
function:
SYSTEM
CONFIGR
F6
IMPORT
F7
EXPORT
F8
DEFINE
DIR
COLOR
SELECT
F1 F3 F9
ARCHIVE
DIR
ASCII
DIR
F4 F6 F7
DEFINE
SELECT
DIR
SOURCE
F1 F3 F4
ARCHIVE
DIR
ASCII
DIR
F4 F6 F7
DEFINE
SELECT
DIR
SOURCE
F1 F3 F4
ANNOTAT
FILES
F1 F3 F4
ARCHIVE
DIR
ASCII
DIR
F4 F6 F7
SAVE
CONFIG
ENTER
DESTIN
ENTER DESTIN
SORT
ORDER
CONFIG
DIR
CONFIG
DIR
CONFIG
DIR
These subfunctions are accessed:
SAVE
CONFIG
F9
SELECT
OPTIONS
SELECT
OPTIONS
KEYWORD
OPTION
IMPORT
SLC&TXT
IMPORT
F5 F7 F8
YES NO
F8 F10
IGN
SLC
ERRORS
ON
COLLISN
F3 F5 F6
SAVE
CONFIG
F9
EXPORT
ACH&DOC
F5 F7 F8
YES NO
F8 F10
SYMBOLSF5ADDRESS
SAVE
CONFIG
F9
SLC
DEFAULT
KEYWORD
EXPORT
ACH
COMMENT
F6 F7 F8
Introducing the
IMPORT
TXT
F9
YES NO
F8 F10
IGN TXT
ERRORS
EXPORT
DOC
F9
YES NO
F8 F10
INSTR
COMMENT
APS Import/Export Utility
[F8]
- YES and [F10] - NO are only displayed when the processor definition is in error, or an overwrite destination file message is displayed.
SAVE
CONFIG
F7
F9
[F8]
- YES and [F10] - NO are only displayed when an overwrite destination file message is displayed.
RUNG
COMMENT
TOGGLE
ENTRY
F1 F2 F3
SAVE
CONFIG
ALL
YES
SELECT
TYPES
F9
F10
ALL NO
1-5
APS Import/Export Utility User Manual
Preface

Starting the Utility

Select a task to perform from table 1.B.
Table 1.B Selecting a Task from the Main Menu
If you want to: Press: Then:
configure the
import/export utility
import a file [F7] - IMPORT
export a file [F8] - EXPORT
exit the utility [F10] - EXIT SYSTEM
[F6] - SYSTEM CONFIGR
see chapter 2, Configuring the APS Import/Export Utility.
see chapter 3, Importing ASCII Documentation/Archive Files.
see chapter 4, Exporting APS Documentation/Archive Files.
APSIE software is terminated, the screen clears, and you are returned to DOS.
1-6
Configuring the
APS Import/Export Utility
2
Configuring the APS Import/Export Software
This
chapter shows you how to:
choose between color and monochrome screens. (Y adaptor card and color monitor to use the color selection.)
specify the user drives and directories
This chapter assumes that you have installed the APS/APSIE software and selected the [F6] – SYSTEM CONFIGR function key from the main menu. If not, see chapter 1, Introducing the APS Import/Export Utility.
ou must have a color
2-1
APS Import/Export Utility User Manual
Preface

Configuring the System

After selecting [F6] – SYSTEM CONFIGR, the import/export utility displays the system configuration screen.
SLC–500 APS IMPORT/EXPORT UTILITY
Rockwell Software Incorporated, Copyright 1989–1995
This softwa
Press a function key
9323 – PA2E
SYSTEM CONFIGURATION
All Rights Reserved F1 Define Directories F3 Color Selection Monochrome F9 Save Configuration
ESC exits/ALT–U aborts changes
From this menu you can do the following:
choose color or monochrome screens
define user directories
save the configuration
Table 2.A explains what to do for either task.
2-2
Configuring the
APS Import/Export Utility
Table 2.A Specifying User Directories or Choosing between Color and Monochrome Screens
If you want to: Press: Then:
specify the user directories
choose between color or monochrome displays
save the configuration permanently
You must have a color adaptor card and color monitor to use the color selection.
Indicates the user preference default.
[F1] - DEFINE DIR
[F3] - COLOR SELECT
[F9] - SAVE CONFIG
see the following section, Specifying the User Directories.
toggle between COLOR and MONOCHROME
SAVE CONFIG or your choice.
APSIE saves the configuration to the user preference file.
, then press [F9] -
[ESC] after making
2-3
APS Import/Export Utility User Manual
Preface

Specifying the User Directories

Below is the user directories screen. The directory paths shown are the default directories when the import/export utility is first run. The maximum number of characters in the pathname is 65. If there are more characters in the pathname than can fit in the window periods (...), for example: “C:\THIS\IS\A\LONG\PATHNAME\FOR\THE\WINDOW...”
, the last 3 characters of the pathname are displayed as three
SLC–500 APS IMPORT/EXPORT UTILITY
User Directories
Window:
These are the
current directories
that the
import/export utility reads
files from and writes files to.
Rockwell Software Incorporated, Copyright 1989–1995
SYSTEM CONFIGURATION
USER DIRECTORIES
F4 APS Archive, Comments and Symbols: C:\IPDS\ARCH\SLC500
F6 ASCII Archive, Comments and Symbols: C:\IPDS\TEXT\SLC500
F7 User Configuration: C:\IPDS\ATTACH\SLC500
F9 Save Configuration
ESC exits/ALT–U aborts changes
Press a Function Key
F1 Define Directories F3 Color Selection Monoc hrome F9 Save Configuration
ESC exits/ALT–U aborts changes
9323 – PA2E
All Rights Reserved
2-4
Configuring the
APS Import/Export Utility
To enter a user directory
, follow these steps:
1. Select the type of directory that you want to specify from table 2.B.
Table 2.B Entering the User Directories
If you want to: Press: Then:
specify the directory where APS archive and documentation files are
[F4] - ARCHIVE DIR the screen below is displayed.
stored
specify the directory where ASCII archive and documentation files are
[F6] - ASCII DIR the screen below is displayed.
stored
specify the directory where the user preference file is
[F7] - CONFIG DIR the screen below is displayed.
stored
save the options displayed on this screen to the user preference file
[F9] - SAVE CONG
APSIE saves the configuration to the user preference file.
The text in the window varies depending on the function key pressed. For example, below is the “APS Archive, Comments and Symbols” window
SLC–500 APS IMPORT/EXPORT UTILITY
.
Rockwell Software Incorporated, Copyright 1989–1995
SYSTEM CONFIGURATION
USER DIRECTORIES
F4 APS Archive, Comments and Symbols: C:\IPDS\ARCH\SLC500
APS ARCHIVE, COMMENTS and SYMBOLS
\ipds\arch\slc500\this\is\a\valid\path
ESC exits/ALT–U aborts changes
F1 Define Directories F3 Color Selection Monoc hrome F9 Save Configuration
ESC exits/ALT–U aborts changes
9323 – PA2E
All Rights Reserved
[ OVERWRITE ]
2-5
APS Import/Export Utility User Manual
Preface
2. Enter the directory pathname. Press [INSERT] to toggle between overwrite
and insert modes.
Overwrite mode – writes over and destroys text that may already exist. Insert mode – writes new text without destroying the already existing text.
3. Press either:
[ENTER] or [ESC] – to save the drive and directory pathname and return to the previous display
OR
[ALT–U] – to discard any changes that were made and return to the previous display.
.
After you press [ENTER], [ESC] or [ALT–U]
, the user directories screen is
displayed. If you want to enter another user directory, return to the start of this section. If you want to save your configuration, press [F9].
2-6
Importing
ASCII Documentation/Archive Files
3
Importing ASCII Documentation/ Archive Files
This
chapter describes how to:
configure the import utility
import ASCII files
examine the results of the import
At this point we assume that you have installed the APS/APSIE software and selected [F7] – IMPORT from the main menu. If not see chapter 1, Introducing the APS Import/Export Utility.
3-1
APS Import/Export Utility User Manual
Preface

Configuring the Import Utility

After selecting [F7] – IMPORT from the main menu, the import screen is displayed.
SLC–500 APS IMPORT/EXPORT UTILITY
DIR Window:
Contains the names
of all the ASCII
source files that exist
in the specified
directory.
Import Files
Window:
Contains the names
of the ASCII
source file and the
APS destination
file selected.
C:\IPDS\TEXT\SLC500
File Names
EXAMPLE1 EXAMPLE2 EXAMPLE3 EXAMPLE4 EXAMPLE5
SLC
Exists
SLC SLC
IMPORT FILES
SOURCE: EXAMPLE1
DESTIN: ABC
ESC exits
Press a Function Key or Enter File Name
In
the DIR window
, notice the abbreviated words SLC" and TXT": SLC indicates that an ASCII archive file exists;
Rockwell Software Incorporated, Copyright 1989–19
This software is licensed to: ALL
9323 – PA2E
All Rights Reserved
NOT NOW
TXT indicates that an ASCII program documentation file exists for a particular filename. (The absence of one or the other means that it does not exist.)
Select an import task to perform from table 3.A.
TXT
TXT
TXT TXT
3-2
Importing
ASCII Documentation/Archive Files
Table 3.A Selecting an Import Task to Perform
If you want to: Press: Then:
define a directory [F1] - DEFINE DIR
use as the import SOURCE file the name of the file that the cursor is on
enter the name of the import destination file
change the various options that control how the import process works
import ASCII archive and documentation files
[F3] - SELECT
SOURCE
[F4] - ENTER DESTIN
[F5] - SELECT
OPTIONS
[F7] - IMPORT SLC &
TXT import an ASCII archive file [F8] - IMPORT SLC see the section, Importing ASCII Files.
import an ASCII documentation file
discard any changes that were made
[F9] - IMPORT TXT see the section, Importing ASCII Files.
the [ESC] key
see chapter 2, Configuring the APS Import/Export Utility.
APSIE places the filename on the SOURCE line.
enter the destination file name or with DESTIN blank, press
[ENTER]
to use the same file name as SOURCE.
see the next section, Selecting Options.
see the section, Importing ASCII Files.
APSIE discards any changes that were made and returns the previous display.
3-3
APS Import/Export Utility User Manual
Preface

Selecting Import Options

After selecting [F5] – SELECT OPTIONS from the main import menu, the import/export utility displays the Import Options window.
SLC–500 APS IMPORT/EXPORT UTILITY
IMPORT
SOURCE
DESTIN:
ESC e
Press a Function Key
Rockwell Software Incorporated, Copyright 1989–19
IMPORT OPTIONS
ASCII ARCHIVE FILE OPTIONS
F3 Ignore SLC Archive Errors NO
ASCII PROGRAM DOCUMENTATION FILE OPTIONS
F5 On Collisions DISCARD
F6 Default Keyword SYMBOL
F7 Ignore TXT Documentation Errors YES
F9 Save Configuration
ESC exits/ALT–U aborts changes
All Rights Reserved
C:\IPDS\TEXT\SLC500
9323 – PA2E
File Names
Exists
TXT
TXT
TXT
TXT
This screen offers you options for configuring the import of both ASCII archive and documentation files. The function keys for this screen, with the exception of [F9] – SAVE CONFIG, toggle through all the possible values for a given option.
For example, the “Ignore TXT Documentation Errors” option: Function key [F7] – IGN TXT ERRORS toggles between the values “yes” and “no”, which are the only possible values for this option.
Note APSIE can import online edit INSERT, REPLACE, and DELETE rungs. You can
only cr
eate these rungs with an SLC 5/03 or SLC 5/04 pr
on the use of these rungs, see the Advanced Programming Softwar
ocessor
. For mor
e details
e User Manual.
3-4
Select import options from table 3.B.
Importing
[F3]
[F3] - IGN SLC
choose the keyword that the
[F6]
[F6] - DEFAULT
documentation file without a
[F7]
[F7] - IGN TXT
Table 3.B Selecting Import Options
If you want to: Toggle: Until the status is:
ignore any errors detected during the archive import process
abort the archive import process when any errors are detected
ignore any duplicate or conflicting entries in the imported ASCII documentation file
overwrite any duplicate or conflicting entries in the imported ASCII documentation file
choose the keyword that the import utility will use for any line in the ASCII
keyword ignore any errors detected
during the documentation import process
abort the documentation import process when any errors are detected.
If you want to: Press: Then:
save the configuration permanently
use this configuration for the session only
discard any changes that were made
Indicates
➁ ➂
the user preference default.
Y
ou can choose only one of the four keywords as the default keyword.
This only applies if you are not using keywords to group similar statements.
- IGN SLC ERRORS
[F5] - ON COLLISION
- DEFAULT KEYWORD
- IGN TXT ERRORS
[F9] - SAVE CONFIG
[ENTER] or [ESC]
[ALT–U]
ASCII Documentation/Archive Files
YES
NO
DISCARD
OVERWRITE
SYMBOL
ADDR. COMMENTS
INSTR. COMMENTS
RUNG COMMENTS
➀➁
YES
NO
APSIE saves the configuration to the user preference file.
APSIE accepts any changes that were made. Once APSIE is terminated, the changes are discarded.
APSIE discards any changes that were made and returns the previous display.
3-5
APS Import/Export Utility User Manual
Preface

Importing ASCII Files

To import an ASCII file, follow these steps:
1. Start on the main import screen shown below.
SLC–500 APS IMPORT/EXPORT UTILITY
Rockwell Software Incorporated, Copyright 1989–19
This software is licensed
IMPORT FILES
SOURCE: EXAMPLE1
Th
DESTIN: ABC
ESC exits
Press a Function Key or Enter File Name
to: ALL
NOT NOW
C:\IPDS\TEXT\SLC500
9323 – PA2E
All Rights Reserved
File Names
EXAMPLE1 EXAMPLE2 EXAMPLE3 EXAMPLE4 EXAMPLE5
2. See table 3.C to perform the import.
Table 3.C Importing ASCII Files
If you want to: Then:
import ASCII archive & documentation files [F7] - IMPORT SLC & TXT
import an ASCII archive file only [F8] - IMPORT SLC
import an ASCII documentation file only [F9] - IMPORT TXT return to the main menu display [ESC]
SLC
SLC SLC
Exists
TXT TXT
TXT TXT
3-6
Importing
ASCII Documentation/Archive Files
Note If
Display Area:
Import Status Area:
These areas provide
continually updated
status information
on the performance
of the import.
the pr
ocessor type is incorr
missing or incorr
pr
ess
[F8] Yes
pr
ess
[F10] No to allow the import to continue (An ar
ect in .SLC file. Configur
to r
ect you ar
econfigure I/O
e immediately pr
e I/O?, You can:
ompted: “Pr
chive file will not be
created).
o corr
ect the I/O configuration, refer to the Advanced Pr
T
ogramming Softwar
User Manual. (APSIE uses the same I/O configuration function as APS.)
Once the import process starts, the following screen is displayed.
Rockwell Software Incorporated
9323 Series Software
SLC–500 IMPORT/EXPORT SOFTWARE
Source: FILE1 Utility: Import Documentation Destin: FILE1 Status: Importing Archive File Phase: Line 5
BEGIN ASCII ARCHIVE IMPORT ASCII ARCHIVE FILE OPTIONS:
IGNORE SLC ARCHIVE ERRORS: NO
PASS 1
ocessor type
e
abort
The information in the bottom window of the import status area provides the same information that is stored in a log file. When the import is complete, you have the option of viewing the log file or returning to the previous screen.
Note You
the newly cr editor.
the import by pr
cannot download the pr
eated APS archive file into APS and then save the file from the offline
essing
[Control – C]
ogram to a pr
ocessor immediately
. Y
ou must first load
3-7
APS Import/Export Utility User Manual
Preface

Examining the Results of the Import

The log file provides the results of the import. It lists any errors that the utility encountered during the import process. For each error, it identifies the type of error and the location where the error was encountered in the ASCII file. “Illegal Addresses” and “Illegal Comments” are two examples of errors that you may encounter.
The default location for the log file is \IPDS\TEXT\SLC500. The log filename consists of the APSIE archive path, which you defined while configuring the import utility using [F6] ASCII DIR, the destination file name which you defined in the import utility using [F4] ENTER DESTIN, and the file extension .LOG.
APSIE also allows you to verify that a new archive file was created. The default location for the archive file is \IPDS\ARCH\SLC500. The archive filename consists of the destination filename and the file extension .ACH.
3-8
Exporting
APS Documentation/Archive Files
4
Exporting APS Documentation/ Archive Files
This
chapter shows you how to:
configure the export utility
export APS files
examine the results of the export
At this point we assume that you have installed the APS/APSIE software and selected [F8] – EXPORT from the main menu. If not, see chapter 1, Introducing the APS Import/Export Utility.
4-1
APS Import/Export Utility User Manual
Preface

Configuring the Export Utility

After selecting [F8] – EXPORT from the main menu, the import/export utility displays the main export screen.
SLC–500 APS IMPORT/EXPORT UTILITY
DIR Window:
Contains the names of all the APS source files
that exist in the specified
directory.
Export Files
Window:
Contains the
names of the APS source file and the
ASCII destination
file selected.
EXPORT FILES
SOURCE: EXAMPLE1
DESTIN: ABC
ESC exits
Press a Function Key or Enter File Name
In
the DIR window
, notice the abbreviated words ACH" and DOC": ACH indicates that an APS archive file exists;
Rockwell Software, Inc.
This software is licensed to: ALL
NOT NOW
9323 – PA All Rights
EXAMPLE1 EXAMPLE2 EXAMPLE3 EXAMPLE4 EXAMPLE5
C:\IPDS\ARCH\SLC500
File Names
ACH
Exists
ACH ACH
DOC indicates that an APS program documentation file exists for a particular filename. (The absence of one or the other means that it does not exist.)
Select an export task to perform from table 4.A.
DOC
DOC
DOC DOC
4-2
Exporting
APS Documentation/Archive Files
Table 4.A Selecting an Export Task to Perform
If you want to: Press: Then:
define a directory
use as the export SOURCE file the name of the file that the cursor is on
[F1] - DEFINE DIR
[F3] - SELECT
SOURCE
enter the name of the export destination file
change the various options that control how the export process works
export APS archive and documentation files
[F4] - ENTER DESTIN
[F5] - SELECT
OPTIONS
[F7] - EXPORT ACH &
DOC export an APS archive file [F8] - EXPORT ACH see the section, Exporting APS Files.
export an APS documentation file
[F9] - EXPORT DOC see the section, Exporting APS Files.
discard any changes made during the session
[ESC]
see Chapter 2, Configuring the User Directory.
APSIE places the filename on the SOURCE line.
enter the destination file name or with DESTIN blank, press
[ENTER]
to use the same file name as SOURCE.
see the next section, Selecting Options.
see the section, Exporting APS Files.
any changes made during the session are discarded and the previous display is returned.
4-3
APS Import/Export Utility User Manual
Preface

Selecting Export Options

After selecting [F5] – SELECT OPTIONS from the main export menu, the import/export utility displays the Export Options window.
SLC–500 APS IMPORT/EXPORT UTILITY
EXPORT OPTIONS
ARCHIVE FILE OPTIONS F1 Annotate ASCII Archive File YES
PROGRAM DOCUMENTATION FILE OPTIONS F3 Sort Order ADDRESS STRING F4 Keyword Option ALL F5 Symbols EXPORT F6 Address Comments DO NOT EXPORT F7 Instruction Comments EXPORT F8 Rung Comments DO NOT EXPORT F10 Select Address Types O,I,S,B,T,C,R,N,F,M0,M1,ST,A,Labels
F9 Save Configuration
ESC exits/ALT–U aborts changes
Press a Function Key
Rockwell Software, Inc. Copyright 1980
This screen offers you options for configuring the export of both APS archive and documentation files. The function keys for this particular screen, with the exception of [F9] – SAVE CONFIG, toggle through all the possible values for a given option.
Take for example the ANNOTAT FILES option: function key [F1] – ANNOTAT FILES toggles between the values “yes” and “no”, which are the only possible values for this option. Select an export option from table 4.B.
Note APSIE can export online edit INSERT, REPLACE, and DELETE rungs. You can
only cr
eate these rungs with an SLC 5/03 or an SLC 5/04 pr
details on the use of these rungs, see the Advanced Programming Softwar
ocessor
. For mor
e User
e
Manual.
4-4
[F1] ANNOTAT FILE
[F3]-SORT ORDER
[]
Exporting
APS Documentation/Archive Files
Table 4.B Selecting Export Options
If you want to: Toggle: Until the status is:
export the ASCII archive file with comments explaining the various sections, like processor type and data tables
[F1] - ANNOTAT FILE
export the ASCII archive file without comments explaining the various sections.
sort by ascending order of the address value, as in: N7:0, N10:2, N10:10
sort by ascending order of the address string as in: N10:10, N10:2, N7:0
sort into groups the
-
comments in the ASCII documentation file in this order: symbols, address, instruction and then rung comments
place all the keywords for symbols, rung, instruction, and address comments at the beginning of every statement in the ASCII documentation file
place keywords at the beginning of groups with similar statements
[F4] - KEYWORD
OPTIONS
remove keywords from the ASCII documentation file
export symbols EXPORT
remove symbols from the
[F5] - SYMBOLS
ASCII documentation file export address comments EXPORT
remove address comments from the ASCII
[F6] - ADDRESS
COMMENTS documentation file.
export instruction comments EXPORT
remove instruction comments from the ASCII
[F7] - INSTR
COMMENTS documentation file
YES
NO
ADDRESS VALUE
ADDRESS STRING
KEYWORD
➀➁
ALL
DEFAULT
NONE
DO NOT EXPORT
DO NOT EXPORT
DO NOT EXPORT
4-5
Loading...
+ 80 hidden pages