Advanced Cards

From CIRPwiki
Jump to navigation Jump to search


Background

The SMS interface has undergone many changes since the CMS model has been supported. During those transitions from SMS 9 to SMS 13.x, some card names have changed or have completely been removed from the interface. This means that the cards found in older files may not be recognized by the newer interface. Another possibility exists where some CMS routines or parameters have not been added to the interface - either intentionally because they are truly for ADVANCED use only or they are very new and just haven't been added yet. These cards still need to be read by CMS and so we have provided ways to get these cards imported to the CMS simulation.

  • SMS 11.0, 11.1, 11.2, and 13.1 each have the capability to read in and save Advanced cards from one simulation to another.
    • Note: This capability was lost in SMS versions between 12.x and 13.0. It was added back to 13.1 but in a different location.
  • If using 12.x or 13.0, the user can manually add the needed cards into a separate text file that should be named 'advanced.cmcards' and placed in the same directory with all the other simulation files that have been exported. If cards are added to the standard <project>.cmcards file, they will be lost the next time the simulation files are exported requiring the user to remember to add them again. The 'advanced.cmcards' file is read after all other cards have been processed from the .cmcards parameter file.
  • In SMS 13.1 and later, the Advanced Cards dialog can be accessed by Right Clicking on the CMS-Flow Simulation and choosing "Advanced Cards..." from the choices.
AdvancedCards.png

The present (SMS 13.4) Advanced Card interface is a simple interface that takes several lines each containing two columns (see image):

  • Card
  • Value

Usage

  • To add or remove new Advanced Cards, click the + or - above the table.
  • Each Card should be the card name that CMS-Flow expects and it should always follow the same requirements:
    • Entirely in uppercase characters
    • No spaces, use underscores instead
    • If the first character is a '!', '#', or '*', the entire line will be ignored by CMS-Flow.
  • Each Value should contain one or more arguments separated by any number of white space.

Note: Different cards will take a different number of arguments. It is up to the user to know how to specify the proper cards for the given Card. SMS provides no validation for Advanced Cards.