All Packages  This Package  Class Hierarchy  Class Search  Index

java.lang.Object
   |
   +----bmsi.edx.EDX

Summary

public class  EDX
     extends java.lang.Object
     implements bmsi.edx.Edxsys, 
                bmsi.edx.Edxtcb, 
                bmsi.edx.Edxprg
{
          // Fields 1
     public static final int MAXPART;

          // Constructors 2
     public EDX() throws EDXException;
     public EDX(String) throws EDXException;

          // Methods 29
     public ActiveTCB active(int, int);
     public void atoe(int, int, int, String);
     public final void attach(short, char, short) throws EDXException;
     public final void cancel(short, char, short) throws EDXException;
     public final void copyIn(int, int, byte[], int, int);
     public final void copyOut(int, int, byte[], int, int);
     public final void deq(short, char, short) throws EDXException;
     public void dispose();
     public String etoa(int, int, int);
     public final char getAddr(int, int);
     public final byte getByte(int, int);
     public final byte[] getBytes(int, int, int);
     public final int getDword(int, int);
     public int getNumpart();
     public MapEntry[] getPartitionMap(int);
     public final String getText(int, int);
     public String getVtab();
     public final short getWord(int, int);
     public final void pcheck(short, char, short) throws EDXException;
     public final void post(short, char, short) throws EDXException;
     public final void putByte(int, int, int);
     public final void putBytes(int, int, byte[]);
     public final void putDword(int, int, int);
     public final void putWord(int, int, int);
     public final void ready(int, int) throws EDXException;
     public synchronized void startinitial() throws EDXException;
     public final void tick() throws EDXException;
     public String toString();
     public PROG wheres(String);
}

A class to interface to a running EDX emulator.

Author:

Stuart D. Gathman Copyright (C) 1998 Business Management Systems, Inc.

Fields

· MAXPART

Summary  |  Top

   public static final int MAXPART

Constructors

· EDX

Summary  |  Top

   public EDX(String vtab)  throws EDXException

Create an interface to an EDX emulator. We can interface to multiple emulators distinguished by which edxvtab.sys file they are using.

Parameter	Description
vtab	The edxvtab.sys file that defines which emulator.

   public EDX()  throws EDXException

Create an interface to the default EDX emulator. It is defined by the edxvtab.sys file in the directory named by the bmsi.edxdir system property, /edx by default.

   public int getNumpart() 

Return the number of partitions in the EDX emulator.

   public String getVtab() 

Return the volume table file that defines this EDX VM.

   public final byte getByte(int key, 
                             int addr) 

Return the BYTE at an EDX address.

   public final void putByte(int key, 
                             int addr, 
                             int val) 

Set the BYTE at an EDX address.

   public final short getWord(int key, 
                              int addr) 

Return the WORD at an EDX address.

   public final char getAddr(int key, 
                             int addr) 

Return the unsigned WORD at an EDX address.

   public final void putWord(int key, 
                             int addr, 
                             int val) 

   public final int getDword(int key, 
                             int addr) 

Return the DWORD at an EDX address.

   public final void putDword(int key, 
                              int addr, 
                              int val) 

Store a DWORD at an EDX address.

   public String etoa(int key, 
                      int addr, 
                      int len) 

Return an EBCDIC char field as a String. No blanks are stripped, you can call trim() if desired.

   public void atoe(int key, 
                    int addr, 
                    int len, 
                    String txt) 

Set an EBCDIC char field from a String. The String will be truncated or padded with blanks to fit in len EBCDIC bytes.

   public final String getText(int key, 
                               int addr) 

Return an EDX TEXT object as a String. No blanks are stripped.

   public final byte[] getBytes(int key, 
                                int addr, 
                                int len) 

Return a copy in a byte[] of a portion of EDX memory.

   public final void putBytes(int key, 
                              int addr, 
                              byte[] b) 

Copy a byte[] into EDX memory.

   public final void copyOut(int key, 
                             int addr, 
                             byte[] b, 
                             int off, 
                             int len) 

Copy EDX memory into a byte array.

   public final void copyIn(int key, 
                            int addr, 
                            byte[] b, 
                            int off, 
                            int len) 

Copy part of a byte array into EDX memory.

   public void dispose() 

Release the resources used by this EDX interface. Subsequent uses will throw an exception.

   public final void ready(int key, 
                           int tcb)  throws EDXException

Wakeup an EDX task.

   public final void deq(short key, 
                         char qcb, 
                         short code)  throws EDXException

Deq an EDX QCB.

   public final void post(short key, 
                          char ecb, 
                          short c)  throws EDXException

Post an EDX event.

   public final void attach(short k, 
                            char tcb, 
                            short c)  throws EDXException

Attach an EDX task.

   public final void pcheck(short k, 
                            char a, 
                            short c)  throws EDXException

Cause a program check in a running EDX program.

   public final void cancel(short k, 
                            char a, 
                            short c)  throws EDXException

Cancel an EDX program. This has the same effect as if the EDX program were to execute PROGSTOP as the next intruction.

Parameter	Description
k	the address key of the program
a	the address of the program
c	the PROGSTOP code

   public final void tick()  throws EDXException

Interrupt EDX execution so that the emulator can check timer queues, run a higher priority TASK, etc.

   public synchronized void startinitial()  throws EDXException

Start $INITIAL in a newly loaded edxnuc. Does nothing if $INITIAL has already been run or the edxnuc is corrupted.

   public ActiveTCB active(int key, 
                           int tcb) 

Get an active TCB context. This determines the default partition as well for a short form of the get/put methods.

Parameter	Description
key	the address key of the tcb
tcb	the tcb address or 0

Returns:

a TCB context

   public MapEntry[] getPartitionMap(int key) 

Return a snapshot of the memory map for an EDX partition.

Parameter	Description
key	the address key for the partition. Partition 1 is address key 0.

Returns:

an array of map entries for the partition, or null if the partition is not allocated.

Throws: ArrayIndexOutOfBoundsException

if the address key is not between 0 and getNumpart().

   public PROG wheres(String progname) 

Find a running EDX program.

Parameter	Description
progname	the name of the program

Returns:

the first program found with a matching name, or null if not found

   public String toString() 

Overrides:

toString in class Object

All Packages  This Package  Class Hierarchy  Class Search  Index